НАЗВА¶

Locale::Po4a::Man — перетворення сторінок підручника на файли PO, і навпаки

ОПИС¶

Метою проекту po4a (PO для усього) є спрощення перекладу (та, що ще цікавіше, супровід перекладів) за допомогою інструментів gettext у областях, де такий переклад спочатку не передбачався, зокрема у документації.

Locale::Po4a::Man — модуль, який допомагає у перекладі документації у форматі nroff (мовою сторінок підручника) іншими мовами (якими розмовляють люди).

ПЕРЕКЛАД ЗА ДОПОМОГОЮ PO4A::MAN¶

Цей модуль намагається зробити завдання перекладача якомога простішим. Для цього текст, який отримає перекладач, не є буквальною копією тексту із сторінки підручника. Найнеоковирніші частини коду nroff приховано так, щоб перекладачі не мали з ними справи.

ПАРАМЕТРИ, ЯКІ МОЖНА ПЕРЕДАВАТИ ЦЬОМУ МОДУЛЮ¶

Ось параметри, які можна передавати цьому модулю:

debug

Задіяти діагностику деяких внутрішніх механізмів цього модуля. Скористайтеся початковим кодом, щоб ознайомитися із частинами, діагностику яких можна виконувати.

verbose

Збільшити рівень докладності повідомлень.

groff_code

Цей параметр надає зомгу зміни поведінку модуля, якщо у даних трапиться розділ .de, .ie або .if. Може приймати такі значення:

generated

Цей параметр вказує на те, що файл було створено автоматично, і po4a не слід намагатися визначити, чи не було сторінки підручника створено на основі іншого формату. Цей параметр надає змогу використовувати po4a для автоматично створених сторінок підручника. Параметру не передаються жодні аргументи.

mdoc

Цей параметр корисний лише для сторінок mdoc.

Вибирає строгіший варіант підтримки формату mdoc, вказуючи po4a, що не слід перекладати розділ «NAME». Для сторінок mdoc, де перекладається розділ «NAME», не створюються верхні і нижні колонтитули.

Відповідно до сторінки groff_mdoc, розділи NAME, SYNOPSIS та DESCRIPTION є обов'язковими. Переклад розділів SYNOPSIS і DESCRIPTION не пов'язано із жодними відомими вадами, але і ці розділи можна вказати у подібний же спосіб:
-o mdoc=NAME,SYNOPSIS,DESCRIPTION

Цю ваду mdoc також можна усунути за допомогою додатка такого вмісту:
PO4A-HEADER:mode=before;position=^.Dd
.TH DOCUMENT_TITLE 1 "День місяця, рік" OS "Назва розділу"

Вказані нижче параметр надають змогу вказати поведінку для нового макросу (визначеного за допомогою запиту .de) або для макросу, підтримку якого не передбачено у po4a. Аргументом цих параметрів є список назв макросів, відокремлених комами. Приклад:

 -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX

Зауваження: якщо підтримку макросу не передбачено у po4a, а ви вважаєте, що це стандартний макрос roff, вам слід повідомити про це команду розробників po4a.

untranslated

untranslated вказує на так, що цей макрос (і його аргументи) не слід перекладати.

noarg

noarg подібний до untranslated, але вказує на те, що po4a слід перевіряти, чи не було додано аргумент до цього макросу.

translate_joined

translate_joined вказує на те, що po4a має запропонувати перекласти аргументи макросу.

translate_each

Якщо вказано translate_each, аргументи також буде запропоновано для перекладу, але кожен із них перекладатиметься окремо.

no_wrap

Цьому параметру передається список відокремлених комами пар початок:кінець, де початок і кінець є командами, які відповідають початку і кінцю розділу, у якому не слід переносити рядки.

Зауваження: програма не виконуватиме ніяких перевірок щодо того, чи є відповідність між командами кінець і початок — будь яка команда завершення розділу зупинятиме дію режиму no_wrap. Якщо у тексті є макрос початок (відповідно, кінець) без відповідника кінець (відповідно, початок), ви можете вказати наявний у тексті кінець (наприклад, fi) або початок (наприклад, nf) як відповідник обмежувача розділу. Ці макроси (та їхні аргументи) не перекладатимуться.

inline

За допомогою цього параметра можна задати список відокремлених комами макросів, за якими не слід ділити на частини поточний абзац. Після цього у рядку для перекладу буде щось подібне до щось <.команда аргументи_команди> далі, де команда — команда, яку слід залишити у ряду, а аргументи_комнади — її аргументи.

unknown_macros

За допомогою цього параметра можна вказати, як po4a має поводитися зі знайденими невідомими макросами. Типово, po4a завершує роботу із попередженням. Параметр може приймати такі значення: failed (типове значення), untranslated, noarg, translate_joined і translate_each (пояснення щодо цих значень наведено вище).

НАПИСАННЯ СУМІСНИХ ІЗ PO4A::MAN СТОРІНОК ПІДРУЧНИКА¶

Можливості цього модуля дуже обмежено, і так буде завжди, оскільки він не є повноцінним інтерпретатором nroff. Можна було б створити справжній інтерпретатор nroff, щоб надати авторам змогу використовувати усі наявні макроси або навіть визначати нові макроси на власних сторінках, але нам не хотілося цього робити. Це надто ускладнило б справу, і нам здається, що у цьому немає потреби. Нам здається, що якщо автори сторінок підручника хочуть, щоб їхню роботу було перекладено, їм буде неважко зробити синтаксис сторінки простішим, щоб спростити роботу перекладачам.

Отже, у обробника сторінок підручника, реалізованого у po4a є декілька відомих обмежень, які ми не хочемо усувати, і які визначають межі певних пасток, до яких ви не повинні потрапити, якщо хочете, щоб над вашою документацією попрацювали перекладачі.

 ..               ."              .AT             .b              .bank
 .BE              ..br            .Bu             .BUGS           .BY
 .ce              .dbmmanage      .do                             .En
 .EP              .EX             .Fi             .hw             .i
 .Id              .l              .LO             .mf
 .N               .na             .NF             .nh             .nl
 .Nm              .ns             .NXR            .OPTIONS        .PB
 .pp              .PR             .PRE            .PU             .REq
 .RH              .rn             .S<             .sh             .SI
 .splitfont       .Sx             .T              .TF             .The
 .TT              .UC             .ul             .Vb             .zZ

 .if !'po4a'hide' .B other

 .IR_untranslated \-q ", " \-\-quiet

 .IR_untranslated \-q ", " \-\-quiet

СТАН ЦЬОГО МОДУЛЯ¶

Цим модулем можна скористатися для більшості наявних сторінок підручника.

Ось результати регулярного тестування у системах Linux:

• причиною помилок під час перетворення однієї третини зі сторінок є те, що їх було автоматично створено на основі іншого формату, підтримку якого передбачено у po4a (наприклад POD або SGML).
• перетворення 10% решти сторінок завершується помилкою (наприклад, через те, що не передбачено підтримки макросу groff).
• Крім того, менше за 1% сторінок вдається обробити за допомогою po4a без помилок, але результати мають суттєві вади (пропущені слова або вставлені нові слова)
• Решту сторінок зазвичай вдається обробити без відмінностей, окрім відмінностей у пробілах або перенесенні рядків (проблеми зі шрифтами виникають на менш ніж 10% оброблених сторінок).

ТАКОЖ ПЕРЕГЛЯНЬТЕ¶

Locale::Po4a::Pod(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

АВТОРИ¶

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)

АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ¶

© SPI, Inc., 2002–2008.

Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL (див. файл COPYING).