Разбор Д/З

Общие замечания:

• Не существует идеального решения — хотя бы потому, что формулировка задания допускает различные варианты, вплоть до применения различных инструментариев
• ⇒ Разбор делится на пять частей:
  0. Условие, при котором задача засчитывается
     • Если это условие не выполнено, баллы за неё обнуляются
  1. Компоненты автоматической проверки (обязательные)
     • Неуспешная проверка по каждому пункту снижает оценку
  2. Обязательная составляющая решения
     • Отсутствие или претензии по каждому пункту снижает оценку
  3. Необязательная (бонусная) составляющая решения
     • Наличие по каждому пункту повышает оценку
  4. Варианты ошибок
     • Наличие по каждому пункту снижает оценку
• Полная проверка решения возможна только вручную

Максимальная оценка должна быть хорошо достижима в ситуации, когда

• автоматическая проверка пройдена,

• все обязательные составляющие присутствуют без особых претензий,

• необязательные составляющие могут отсутствовать,

• ошибок нет.

Задание по лекции 08_I18n

Далее рассматривается решение в варианте, когда

• используются Autotools (а не CMake / Meson)

• для сборки перевода используются средства Autotools (а не вручную)

guesser
├── configure.ac
├── Makefile.am
├── po
│   ├── Makevars
│   ├── POTFILES.in
│   └── ru.po
└── src
    ├── guesser.c
    └── Makefile.am

Условие сдачи

• Есть способ добиться запуска программы, при котором можно наблюдать (хотя бы на некоторых сообщениях) как исходный текст, так и его перевод в зависимости от локали

Компоненты автоматической проверки

• В репозитории есть все файлы: configure.ac, Makefile.am, po/*.po, po/POTFILES.in, po/Makevars

• В файле configure.ac используются макросы AM_GNU_GETTEXT и ALL_LINGUAS

• Все подстроки #include <libintl.h>, #include <locale.h>, setlocale, textdomain и gettext можно найти в файлах **/*.[ch]

• В репозитории нет общих генератов (*.o, *.a, *.so и других файлов формата ELF)

• В репозитории нет PO-генератов (*.pot, *.mo, *.gmo)

Обязательная составляющая

1. Сборка autoreconf -fisv && ./configure && make

2. Сборка и установка ./configure --prefix=/tmp/QQ && make clean install

3. Запуск после установки: /tmp/QQ/bin/имя_программы

   • переводы могут не работать

4. ∃ способ запуска, при котором переводы работают

5. Обрабатываются ситуации неправильного ввода
6. Обрабатывается ситуация закрытия ввода

Необязательная составляющая

1. Обработка ошибок вызываемых функций, если они могут завершиться с ошибками
   • В этом задании допустимо такую обработку не делать

2. Дополнительная настройка configure.ac / configure, позволяющая указать при сборке каталог с переводами (и тестировать запуск без установки)

3. Программа угадывает число не более, чем за 7 вопросов

Варианты ошибок

1. В репозитории хранятся генераты autopoint (фактически — что угодно из каталога po, кроме файла с переводами, Makevars и POTFILES.in

   • ├── configure.ac
     ├── Makefile.am
     ├── po
     │   ├── Makevars
     │   ├── Makevars.template
     │   ├── POTFILES.in
     │   ├── ru.mo
     │   └── ru.po
     └── src
         ├── guesser.c
         └── Makefile.am

2. Какая-то часть вывода не переведена (например, сообщения об ошибках)

   $ echo "Wat" | ~/tmp/QQ/bin/guesser
   Выберите число из диапазона от 1 до 100.
   Задуманное число больше 50 (Да/Нет)? /home/george/tmp/QQ/bin/guesser: Incorrent answer 'Wat'

3. Каталог с переводами явно указан в тексте программы (а не определяется autotools)

    …
    bindtextdomain(PACKAGE, "po");
    …

   • В этом примере явно задан каталог "po"