Difference between revisions of "Локализация системы"
(Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[Ло...") |
|||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Локализация системы]] | Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[Локализация системы]] | ||
| + | |||
| + | Система <tt>ejudge</tt> поддерживает настройку языка пользовательского интерфейса, хотя текущая версия системы обладает рядом недостатков. | ||
| + | |||
| + | Переключения языка пользовательского интерфейса выполняется через стандартный механизм трансляции сообщений <tt>gettext</tt>. В настоящее время система поддерживает только два языковых окружения — C (окружение по умолчанию для программ на Си) и | ||
| + | <tt>ru_RU.KOI8-R</tt> (русский язык в кодировке koi-r), которые имеют идентификаторы 0 и 1 | ||
| + | соответственно. Для того, чтобы добавить новое языковое окружение, необходимо модифицировать исходный файл <tt>l10n.c</tt>. Переведённые тексты сообщений находятся в файлах | ||
| + | <tt>ejudge.</tt>''LOCALE.''<tt>po</tt>, где ''LOCALE'' — имя языкового окружения. | ||
| + | |||
| + | Если при компиляции системы <tt>ejudge</tt> скрипт <tt>[[configure]]</tt> обнаружил в системе все необходимые библиотеки и программы, поддержка языкового окружения включается автоматически. В этом случае нет необходимости в ручной правке конфигурационных файлов. Однако, | ||
| + | если необходимо отключить поддержку языкового окружения нужно воспользоваться опцией | ||
| + | <tt>--disable-nls</tt> скрипта <tt>[[configure]]</tt>. | ||
| + | |||
| + | Поэтому дальнейшие подразделы представляют интерес только в случае, если требуется | ||
| + | вручную изменить настройки поддержки языкового окружения. | ||
| + | |||
| + | ===Включение поддержки языкового окружения=== | ||
| + | Чтобы включить поддержку языкового окружения, необходимо установить конфигурационный | ||
| + | параметр в файлах настройки утилит. Для конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt> | ||
| + | <tt>[[register.xml]]</tt>, <tt>[[users.xml]]</tt>) это атрибут <tt>l10n</tt> элемента верхнего уровня конфигурационного файла. Например, для конфигурационного файла <tt>ejudge.xml</tt> установка атрибута локализации сообщений может выглядеть следующим образом: | ||
| + | <?xml version="1.0" encoding="koi8-r"?> | ||
| + | <config l10n="yes"> | ||
| + | <nowiki><!-- прочие элементы --></nowiki> | ||
| + | </config> | ||
| + | Для конфигурационных файлов в текстовом формате (<tt>[[serve.cfg]]</tt>, <tt>[[master.cfg]]</tt>, <tt>[[judge.cfg]]</tt>, | ||
| + | <tt>[[team.cfg]]</tt>) это параметр <tt>enable_l10n</tt>, который необходимо установить. Для любого конфигурационного установка атрибута локализации может выглядеть следующим образом: | ||
| + | enable_l10n | ||
| + | |||
| + | === Установка каталога сообщений === | ||
| + | Чтобы система <tt>ejudge</tt> смогла использовать переводы сообщений, в конфигурационных файлах | ||
| + | утилит необходимо указать каталог сообщений (message catalog), в котором находятся файлы c переведёнными сообщениями. По умолчанию после выполнения команды <tt>make install</tt> каталоги | ||
| + | сообщений помещаются в каталог, определяемой переменной <tt>INST_LOCALE_PATH</tt> в <tt>makefile</tt>. | ||
| + | |||
| + | Именно этот каталог должен быть указан в конфигурационных файлах. Для конфигурационных файлов в формате XML (<tt>[[ejudge.xml]]</tt> <tt>[[register.xml]]</tt>, <tt>[[users.xml]]</tt>) каталог сообщений устанавливается с помощью элемента <tt>l10n_dir</tt>, например, следующим образом: | ||
| + | <l10n_dir>/usr/share/locale</l10n_dir> | ||
| + | |||
| + | Для конфигурационных файлов в текстовом формате (serve.cfg, master.cfg, judge.cfg, | ||
| + | team.cfg) каталог сообщений устанавливается с помощью параметра l10n_dir, например, следующим образом: | ||
| + | l10n_dir = "/usr/share/locale" | ||
Latest revision as of 14:37, 21 February 2012
Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/Локализация системы
Система ejudge поддерживает настройку языка пользовательского интерфейса, хотя текущая версия системы обладает рядом недостатков.
Переключения языка пользовательского интерфейса выполняется через стандартный механизм трансляции сообщений gettext. В настоящее время система поддерживает только два языковых окружения — C (окружение по умолчанию для программ на Си) и ru_RU.KOI8-R (русский язык в кодировке koi-r), которые имеют идентификаторы 0 и 1 соответственно. Для того, чтобы добавить новое языковое окружение, необходимо модифицировать исходный файл l10n.c. Переведённые тексты сообщений находятся в файлах ejudge.LOCALE.po, где LOCALE — имя языкового окружения.
Если при компиляции системы ejudge скрипт configure обнаружил в системе все необходимые библиотеки и программы, поддержка языкового окружения включается автоматически. В этом случае нет необходимости в ручной правке конфигурационных файлов. Однако, если необходимо отключить поддержку языкового окружения нужно воспользоваться опцией --disable-nls скрипта configure.
Поэтому дальнейшие подразделы представляют интерес только в случае, если требуется вручную изменить настройки поддержки языкового окружения.
Включение поддержки языкового окружения
Чтобы включить поддержку языкового окружения, необходимо установить конфигурационный параметр в файлах настройки утилит. Для конфигурационных файлов в формате XML (ejudge.xml register.xml, users.xml) это атрибут l10n элемента верхнего уровня конфигурационного файла. Например, для конфигурационного файла ejudge.xml установка атрибута локализации сообщений может выглядеть следующим образом:
<?xml version="1.0" encoding="koi8-r"?> <config l10n="yes"> <!-- прочие элементы --> </config>
Для конфигурационных файлов в текстовом формате (serve.cfg, master.cfg, judge.cfg, team.cfg) это параметр enable_l10n, который необходимо установить. Для любого конфигурационного установка атрибута локализации может выглядеть следующим образом:
enable_l10n
Установка каталога сообщений
Чтобы система ejudge смогла использовать переводы сообщений, в конфигурационных файлах утилит необходимо указать каталог сообщений (message catalog), в котором находятся файлы c переведёнными сообщениями. По умолчанию после выполнения команды make install каталоги сообщений помещаются в каталог, определяемой переменной INST_LOCALE_PATH в makefile.
Именно этот каталог должен быть указан в конфигурационных файлах. Для конфигурационных файлов в формате XML (ejudge.xml register.xml, users.xml) каталог сообщений устанавливается с помощью элемента l10n_dir, например, следующим образом:
<l10n_dir>/usr/share/locale</l10n_dir>
Для конфигурационных файлов в текстовом формате (serve.cfg, master.cfg, judge.cfg, team.cfg) каталог сообщений устанавливается с помощью параметра l10n_dir, например, следующим образом:
l10n_dir = "/usr/share/locale"
