Linux программирование в примерах, Роббинс Арнольд

Linux программирование в примерах

на обложку

Роббинс Арнольд

Шрифт:

"Le %2$s %1$s te regarde d'un aire interrogateur.\n"

(Даже этот перевод не совершенен: артикль «Le» имеет род. Подготовка программы к переводу трудная задача!)

13.3.6. Тестирование переводов в персональном каталоге

Коллекция сообщений в программе называется списком сообщений (message catalog). Этот термин применяется также к каждому из переводов сообщений на другой язык. Когда программа установлена, каждый перевод также устанавливается в стандартное место, где

gettext

может во время исполнения найти нужный перевод.

Может оказаться полезным разместить переводы не в стандартном, а в другом каталоге, особенно для тестирования программы. Особенно на больших системах, у обычного пользователя может не быть необходимых разрешений для установки файлов в системные каталоги. Функция

bindtextdomain

дает

gettext

альтернативное место для поиска переводов:

#include <libintl.h> /* GLIBC */

char *bindtextdomain(const char *domainname,

const char *dirname);

Полезные каталоги включают '

' для текущего каталога и

/tmp

. Может оказаться удобным также получить каталог из переменной окружения, подобно этому:

char *td_dir;

setlocale(LC_ALL, "");

textdomain("killerapp");

if ((td_dir = getenv("KILLERAPP_TD_DIR")) != NULL)

bindtextdomain("killerapp", td_dir);

bindtextdomain

должна быть вызвана до вызовов любой из функций из семейства

gettext

. Мы увидим пример ее использования в разделе 13.3.8 «Создание переводов»

13.3.7. Подготовка интернационализированных программ

К настоящему моменту мы рассмотрели все компоненты, из которых состоит интернационализированная программа. Данный раздел подводит итоги.

1. Включите в свое приложение заголовочный файл

gettext.h

, добавьте определения для макросов

в заголовочный файл, который включается во все ваши исходные файлы на С. Не забудьте определить именованную константу

ENABLE_NLS

2. Вызовите соответствующим образом

setlocale

. Проще всего вызвать '

setlocale(LC_ALL, "")

', но иногда приложению может потребоваться быть более разборчивым в отношении используемых категорий локали.

3. Выберите для приложения текстовый домен и установите его с помощью

textdomain

4. При тестировании свяжите текстовый домен с определенным каталогом при помощи

bindtextdomain

5. Используйте соответствующим образом

strfmon

strftime

и флаг

. Если нужна другая информация о локали, используйте

nl_langinfo

, особенно в сочетании с

strftime

6. Пометьте все строки, которые должны быть переведены, соответствующими вызовами

или

Хотя некоторые не следует так помечать. Например, если вы используете

getopt_long

(см. раздел 2.1.2 «Длинные опции GNU»), вы, вероятно, не захотите, чтобы имена длинных опций были помечены для перевода. Не требуют перевода и простые форматирующие строки наподобие "

%d %d\n

", также как отладочные сообщения.

7. В нужных местах используйте

ngettext

(или ее варианты) для значений, которые могут быть 1 или больше 1.

8. Упростите жизнь для своих переводчиков, используя строки с полными предложениями вместо замены слов с помощью

. Например:

if (/* возникла ошибка */) { /* ВЕРНО */

/* Использовать несколько строк для упрощения перевода. */

if (input_type == INPUT_FILE)

fprintf(stderr, _("%s: cannot read file: %s\n"),

argv[0], strerror(errno));

else

fprintf(stderr, _("%s: cannot read pipe: %s\n"),

argv[0], strerror(errno));

Это лучше, чем

if (/* возникла ошибка */) { /* НЕВЕРНО */

fprintf(stderr, _("%s: cannot read %s: %s\n"), argv[0],

input_type == INPUT_FILE ? _("file") : _("pipe"),

strerror(errno));

}

Как только что показано, хорошей мыслью является включение комментария, сообщающего о намеренном использовании нескольких строк, чтобы упростить перевод сообщений.

13.3.8. Создание переводов

После интернационализации программы необходимо подготовить переводы. Это осуществляется с помощью нескольких инструментов уровня оболочки. Мы начнем с интернационализированной версии

ch06-echodate.c

из раздела 6.1.4 «Преобразование разложенного времени в

time_t

»:

/* ch13-echodate.c --- демонстрация переводов */

#include <stdio.h>

#include <time.h>

#include <locale.h>

#define ENABLE_NLS 1

#include "gettext.h"

#define _(msgid) gettext(msgid)

#define N_(msgid) msgid