Alterator/l10n: различия между версиями

Материал из ALT Linux Wiki
м (→‎Добавление языка: на примере da_DK)
 
(не показаны 24 промежуточные версии 7 участников)
Строка 1: Строка 1:
'''alterator-l10n'''
[[ruwp:Локализация|Локализация]] (l10n) — процесс адаптации [[Alterator/i18n|специально подготовленного]] ранее приложения для конкретного языка.
 
В alterator для каждого модуля автоматически создаётся словарь с переводом сообщений интерфейса и бэкендов. Отдельно переводится текст встроенной справки.


== Справка ==
== Справка ==
=== Старая схема ===
Файл со справочной информацией сохраняется либо в alterator-l10n либо в самом модуле, устанавливается в {{path|/usr/share/alterator/help/}}
* хелпы хранятся в пакете alterator-l10n, устанавливаются в директорию {{path|/usr/share/alterator/l10n/help/}} и ''не'' используются альтератором
* модуль, использующий хелп из alterator-l10n должен иметь сборочную зависимость на alterator-l10n
* при сборке модуля хелпы автоматически берутся из {{path|/usr/share/alterator/l10n/help/}} и устанавливаются в директорию {{path|/usr/share/alterator/help/}}, где их и ищет альтератор.
*: (неочевидная хитрость: хелп устанавливается только, если он упомянут в desktop-файле модуля)
 
Таким образом, при изменении хелпа в alterator-l10n следует пересобирать модуль.
 
=== Новая схема ===
* Хелп пакуется либо в alterator-l10n либо в модуль и в любом случае устанавливается сразу в {{path|/usr/share/alterator/help/}}
 
При правке хелпа пересборки модуля не требуется.
 
В 4.1 работает только старая схема, в 5.0 и Сизифе — обе схемы. Для поддержки двух схем в исходниках пакета {{pkg|alterator-l10n}} сделаны директории {{path|old_help}} и {{path|new_help}}. При переходе со старой схемы на новую надо следить, чтобы хелп не оказался запакован и в alterator-l10n и в модуль, и не возникло конфликта.


== Переводы ==
== Переводы ==
=== Старая схема ===
=== Обновление ===
* словарь, общий для всех модулей, лежит в alterator-l10n
С точки зрения мейнтейнера модуля устроено так:
* существует процедура обновления словаря, при которой по списку обновляются git-репозитории для всех модулей, использующих alterator-l10n, в них генерятся pot-файлы, берутся po-файлы и затем мерджатся с общим словарем внутри alterator-l10n.
* модуль, использующий переводы из alterator-l10n должен иметь сборочную зависимость на alterator-l10n
* при сборке модуля переводы автоматически берутся из alterator-l10n, создаётся отдельный словарь для данного модуля и устанавливается в систему.
 
=== Недостатки старой схемы ===
* При изменении модуля, приходится пересобирать alterator-l10n, а затем — опять модуль.
* При пересборке alterator-l10n требуется иметь актуальные git-репозитории для всех модулей, которые используют alterator-l10n (в том числе, за которыми я вообще не слежу). Дело осложнено тем, что для модулей альтератора сложилась традиция сборки, при которой неясно, в чьём репозитории в данный момент находится актуальная версия. Существуют, впрочем «нечестные» способы обновления базы переводов alterator-l10n.
* «Общий» файл переводов очень неудобно мерджить, в случае, если несколько человек параллельно обновляют alterator-l10n
* «Общий» файл переводов неудобно переводить без контекста.
* В модуле, не использующем alterator-l10n может быть нужна сборочная зависимость на модуль, использующий alterator-l10n. В этом случае локальные переводы пропадут из модуля.
 
Новая схема решает все эти проблемы.
 
=== Новая схема ===
В данный момент новая схема почти реализована и работает параллельно со старой. На неё переведены модули alterator-{x11,lilo,xinetd,services,samba}
 
С точки зрения мантейнера модуля устроено так:


* В alterator-l10n находится общий словарь (обновляется редко, «переводчиками»).
* В alterator-l10n находится общий словарь (обновляется редко, «переводчиками»).
* Там же есть отдельные словари для каждого модуля (обновляются при обновлении модулей, «мейнтейнерами модулей»).
* Там же есть отдельные словари для каждого модуля (обновляются при обновлении модулей, «мейнтейнерами модулей»).
* Находясь в alterator-l10n обновляем словарь своего модуля модуля: '''./update_module <директория с модулем>''' (директория с модулем -- та, в которой живет Makefile). При этом недостающие переводы берутся из общего словаря.
* Находясь в alterator-l10n обновляем словарь своего модуля модуля: '''./update_module <директория с модулем>''' (директория с модулем та, в которой живет Makefile). При этом недостающие переводы берутся из общего словаря. '''Примечание''': требуется установленный alterator >= 3.5-alt1.
* При первом запуске update_module (если словаря для этого модуля еще нет в alterator-l10n), словарь берётся из модуля.
* Правим словарь своего модуля в alterator-l10n/po/<язык>/<имя>.po
* Правим словарь своего модуля в alterator-l10n/po/<язык>/<имя>.po
* Коммитим, пушим, просим мейнтейнера alterator-l10n втянуть…
* Коммитим, пушим, просим мейнтейнера alterator-l10n втянуть…
Строка 47: Строка 20:


С точки зрения переводчика:
С точки зрения переводчика:
* можно добавлять переводы в общий словарь (при пересборке alterator-l10n они добавятся во все словари модулей)
* можно добавлять переводы в общий словарь (при пересборке alterator-l10n они добавятся во все словари модулей)
* можно править переводы в модулях
* можно править переводы в модулях
Строка 52: Строка 26:
* Все это происходит только внутри alterator-l10n, при изменениях модули пересобирать не нужно.
* Все это происходит только внутри alterator-l10n, при изменениях модули пересобирать не нужно.


[[Изображение:alterator-l10n-pr1.png]]
[[Файл:alterator-l10n-pr1.png]]


Некоторая особенность связана с переводами полей Name и Comment в desktop-файлах. Использовать gettext при разборе desktop-файлов не хочется (при этом для построения главного меню придется каждый перевод вытаскивать из своего словаря, что долго и странно), хочется переводы таскать внутри desktop-файлов, однако дать возможность переводчикам переводить их внутри alterator-l10n.
Некоторая особенность связана с переводами полей {{term|Name}} и {{term|Comment}} в desktop-файлах. Использовать gettext при разборе desktop-файлов не хочется (при этом для построения главного меню придётся каждый перевод вытаскивать из своего словаря, что долго и странно), хочется переводы таскать внутри desktop-файлов, однако дать возможность переводчикам переводить их внутри alterator-l10n.


Сейчас сделано так:
Сейчас сделано так:
* строчки для перевода вытаскиваются в alterator-l10n точно также, как и все остальное.
* строчки для перевода вытаскиваются в alterator-l10n точно также, как и все остальное.
* запуская в alterator-l10n скрипт './update_desktop <директория с модулем>' мы обновляем desktop-файлы модуля...
* запуская в alterator-l10n скрипт {{cmd|./update_desktop <директория с модулем>}} мы обновляем desktop-файлы модуля…


Оставшаяся проблема: скрипт для сливания общего словаря из всех модулей — синяя стрелка на картинке. Это несложно сделать, но пока общий словарь также используется для построения словарей модулей в старой схеме, это лучше делать хитрее и вручную.
Оставшаяся проблема: скрипт для сливания общего словаря из всех модулей — синяя стрелка на картинке. Это несложно сделать, но пока общий словарь также используется для построения словарей модулей в старой схеме, это лучше делать хитрее и вручную.


[[Категория:Sisyphus]]
=== Добавление языка ===
На примере [http://lists.altlinux.org/pipermail/community-en/2022-January/001391.html датского]:
$ mkdir po/<u>da</u>
$ touch compendium/<u>da</u>.po ''# заполняется по аналогии с соседями''
$ echo "Dansk" > l10n/11-<u>da_DK</u> ''# название языка на нём самом''
$ gear-edit-spec ''# на предмет добавления нужного %lang(<u>da</u>)''
 
== Старая схема (бранч 4.1) ==
 
=== Справка ===
* файлы справки хранятся в пакете alterator-l10n, устанавливаются в директорию {{path|/usr/share/alterator/l10n/help/}} и ''не'' используются альтератором
* модуль, использующий хелп из alterator-l10n, должен иметь сборочную зависимость на alterator-l10n
* при сборке модуля справка автоматически берется из {{path|/usr/share/alterator/l10n/help/}} и устанавливается в директорию {{path|/usr/share/alterator/help/}}, где её и ищет альтератор. Таким образом, при изменении справки в alterator-l10n следует пересобирать модуль.
* файл справки устанавливается только если он упомянут в desktop-файле модуля
 
=== Переводы ===
* словарь, общий для всех модулей, лежит в alterator-l10n
* существует процедура обновления словаря, при которой по списку обновляются git-репозитории для всех модулей, использующих alterator-l10n, в них генерятся pot-файлы, берутся po-файлы и затем мерджатся с общим словарём внутри alterator-l10n.
* модуль, использующий переводы из alterator-l10n, должен иметь сборочную зависимость на alterator-l10n
* при сборке модуля переводы автоматически берутся из alterator-l10n, создаётся отдельный словарь для данного модуля и устанавливается в систему.
 
{{Category navigation|title=Alterator|category=Alterator|sortkey={{SUBPAGENAME}}}}

Текущая версия от 11:08, 3 февраля 2022

Локализация (l10n) — процесс адаптации специально подготовленного ранее приложения для конкретного языка.

В alterator для каждого модуля автоматически создаётся словарь с переводом сообщений интерфейса и бэкендов. Отдельно переводится текст встроенной справки.

Справка

Файл со справочной информацией сохраняется либо в alterator-l10n либо в самом модуле, устанавливается в /usr/share/alterator/help/

Переводы

Обновление

С точки зрения мейнтейнера модуля устроено так:

  • В alterator-l10n находится общий словарь (обновляется редко, «переводчиками»).
  • Там же есть отдельные словари для каждого модуля (обновляются при обновлении модулей, «мейнтейнерами модулей»).
  • Находясь в alterator-l10n обновляем словарь своего модуля модуля: ./update_module <директория с модулем> (директория с модулем — та, в которой живет Makefile). При этом недостающие переводы берутся из общего словаря. Примечание: требуется установленный alterator >= 3.5-alt1.
  • При первом запуске update_module (если словаря для этого модуля еще нет в alterator-l10n), словарь берётся из модуля.
  • Правим словарь своего модуля в alterator-l10n/po/<язык>/<имя>.po
  • Коммитим, пушим, просим мейнтейнера alterator-l10n втянуть…
  • Из своего модуля убираем паковку mo-файлов (иначе будет конфликт!) и (если уже и хелп переведён на новую схему) вообще сборочную зависимость на alterator-l10n
  • При сборке alterator-l10n для каждого модуля соберутся и установятся в систему mo-файлы. Причём недостающие переводы опять возьмутся из общего словаря.

С точки зрения переводчика:

  • можно добавлять переводы в общий словарь (при пересборке alterator-l10n они добавятся во все словари модулей)
  • можно править переводы в модулях
  • можно слить переводы модулей в общий словарь (msgcat), посмотреть на несоответствия переводов и разобраться с каждым несоответствующем модулем по отдельности
  • Все это происходит только внутри alterator-l10n, при изменениях модули пересобирать не нужно.

Alterator-l10n-pr1.png

Некоторая особенность связана с переводами полей Name и Comment в desktop-файлах. Использовать gettext при разборе desktop-файлов не хочется (при этом для построения главного меню придётся каждый перевод вытаскивать из своего словаря, что долго и странно), хочется переводы таскать внутри desktop-файлов, однако дать возможность переводчикам переводить их внутри alterator-l10n.

Сейчас сделано так:

  • строчки для перевода вытаскиваются в alterator-l10n точно также, как и все остальное.
  • запуская в alterator-l10n скрипт ./update_desktop <директория с модулем> мы обновляем desktop-файлы модуля…

Оставшаяся проблема: скрипт для сливания общего словаря из всех модулей — синяя стрелка на картинке. Это несложно сделать, но пока общий словарь также используется для построения словарей модулей в старой схеме, это лучше делать хитрее и вручную.

Добавление языка

На примере датского:

$ mkdir po/da
$ touch compendium/da.po # заполняется по аналогии с соседями
$ echo "Dansk" > l10n/11-da_DK # название языка на нём самом
$ gear-edit-spec # на предмет добавления нужного %lang(da)

Старая схема (бранч 4.1)

Справка

  • файлы справки хранятся в пакете alterator-l10n, устанавливаются в директорию /usr/share/alterator/l10n/help/ и не используются альтератором
  • модуль, использующий хелп из alterator-l10n, должен иметь сборочную зависимость на alterator-l10n
  • при сборке модуля справка автоматически берется из /usr/share/alterator/l10n/help/ и устанавливается в директорию /usr/share/alterator/help/, где её и ищет альтератор. Таким образом, при изменении справки в alterator-l10n следует пересобирать модуль.
  • файл справки устанавливается только если он упомянут в desktop-файле модуля

Переводы

  • словарь, общий для всех модулей, лежит в alterator-l10n
  • существует процедура обновления словаря, при которой по списку обновляются git-репозитории для всех модулей, использующих alterator-l10n, в них генерятся pot-файлы, берутся po-файлы и затем мерджатся с общим словарём внутри alterator-l10n.
  • модуль, использующий переводы из alterator-l10n, должен иметь сборочную зависимость на alterator-l10n
  • при сборке модуля переводы автоматически берутся из alterator-l10n, создаётся отдельный словарь для данного модуля и устанавливается в систему.