НАЗВА¶

Locale::Po4a::Xml — перетворення документів XML та похідних документів на файли PO, і навпаки

ОПИС¶

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

Locale::Po4a::Xml — модуль, який допомагає у перекладі документів XML іншими мовами (якими розмовляють люди). Модулем можна також скористатися як основою для побудови модулів для заснованих на XML документів.

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

Цим модулем можна скористатися для роботи із типовими документами XML. Він видобуває увесь вміст теґів, не видобуває атрибути, оскільки текст у більшості документів на основі XML міститься саме у теґах.

Передбачено декілька параметрів (які описано у наступному розділі), за допомогою яких можна налаштувати поведінку модуля. Якщо модуль не відповідає формату вашого документа, вам варто написати власний модуль, який походитиме від цього, і у якому ви опишете параметри формату. Опис процедури написання наведено у розділі НАПИСАННЯ ПОХІДНИХ МОДУЛІВ нижче.

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

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

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

nostrip

Запобігає вилученню пробілів на початку і наприкінці видобутих рядків.

wrap

Переводить рядок для перекладу у канонічну форму, де пробіли вважаються неважливими, а рядки у перекладеному документі переносяться. Цей параметр можна перевизначити параметрами нетипових теґів. Див. параметр translated нижче.

unwrap_attributes

Типово, рядки з атрибутами переносяться. За допомогою цього параметра можна заборонити таке перенесення.

caseinsensitive

Наказує модулю виконувати пошук теґів і атрибутів без враховування регістру символів. Якщо визначено, модуль оброблятиме <BooK>laNG і <BOOK>Lang як <book>lang.

escapequotes

Екранувати лапки у виведених рядках. Таке екранування є обов'язковим, наприклад, для створення рядкових ресурсів, які використовуватимуться у засобах збирання Android.

Див. також https://developer.android.com/guide/topics/resources/string-resource.html

includeexternal

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

ontagerror

Цей параметр визначає поведінку модуля, якщо буде виявлено некоректний синтаксис XML (кінцевий теґ, який не відповідає останньому початковому теґу). Може приймати такі значення:

tagsonly

Зауваження: цей параметр вважається застарілим.

Видобувати лише з теґів, вказаних за допомогою параметра «tags». Якщо не вказано, видобуватиметься вміст усіх теґів, окрім вказаних як такі, які є непридатними для видобування.

doctype

Рядок, який слід шукати у першому рядку doctype документа (якщо визначено). Якщо такий рядок не буде знайдено, модуль покаже повідомлення про те, що документ може належати до не того типу.

addlang

Рядок, який вказує шлях (наприклад, <bbb><aaa>) до теґу, до якого слід додати атрибут lang="...". Мову буде визначено на основі базової назви файла PO без суфікса .po.

optionalclosingtag

Булеве значення, яке вказує на те, чи є завершальні теґи необов'язковими (як у HTML). Типово, пропущені завершальні теґи призводять до сповіщення про помилку, обробка якого виконується відповідно до "ontagerror".

tags

Зауваження: цей параметр вважається застарілим. Замість нього, вам слід користуватися параметрами translated і untranslated.

Список відокремлених пробілами теґів, вміст яких ви хочете перекласти або пропустити. Типово, вміст вказаних теґів буде виключено, але якщо вказано параметр «tagsonly», буде включено лише вміст вказаних теґів. Теґи слід вказувати у форматі <aaa>, але ви можете поєднати деякі теґи (<bbb><aaa>), щоб вказати, наприклад, що вміст теґу <aaa> перекладатиметься, лише якщо його включено до теґу <bbb>.

Ви також можете вказати деякі параметри теґів, додаючи символи перед ієрархією теґів. Наприклад, ви можете додати «w» (переносити) або «W» (не переносити), щоб перевизначити типову поведінку, вказано за допомогою загального параметра «wrap».

Приклад: W<chapter><title>

attributes

Список відокремлених пробілами атрибутів теґів, які ви хочете перекласти. Ви можете вказати атрибути за назвою (наприклад, «lang»), а можете додати префікс із ієрархії теґів, щоб вказати, що певний атрибути перекладатиметься, лише якщо він перебуває у вказаному тезі. Приклад: запис <bbb><aaa>lang означає, що атрибут lang перекладатиметься, лише якщо він перебуває у тезі <aaa>, який перебуває у тезі <bbb>.

foldattributes

Не перекладати атрибути у вбудованих в абзац теґах. Замість цього, замінити усі атрибути теґу записом po4a-id=<id>.

Корисно, якщо атрибути не слід перекладати, оскільки спрощує роботу перекладача і надає змогу уникнути друкарських помилок.

customtag

Список відокремлених пробілами теґів, які не слід вважати теґами. Ці теґи вважатимуться вбудованими у текст теґами, які не потребують закриття.

break

Список відокремлених пробілами теґів, які розривають послідовність обробки. Типово, усі теґи розривають послідовність обробки.

Теґи слід вказувати у форматі <aaa>, але ви можете об'єднати декілька (<bbb><aaa>), якщо один теґ (<aaa>) слід брати до уваги, лише якщо він перебуває усередині іншого теґу (<bbb>).

Будь ласка, зауважте, що теґ має бути вказано лише у одному зі списків параметрів break, inline placeholder або customtag.

inline

Список відокремлених пробілами теґів, які слід вважати вбудованими до абзацу. Типово, усі теґи розривають послідовність обробки тексту.

Теґи слід вказувати у форматі <aaa>, але ви можете об'єднати декілька (<bbb><aaa>), якщо один теґ (<aaa>) слід брати до уваги, лише якщо він перебуває усередині іншого теґу (<bbb>).

placeholder

Список відокремлених пробілами теґів, які слід вважати замінниками. до абзацу Замінники не розривають послідовність обробки тексту, але вміст замінників перекладається окремо.

Розташування замінника у його блоці буде позначено рядком, подібним до такого:

  <placeholder type=\"footnote\" id=\"0\"/>
    

Теґи слід вказувати у форматі <aaa>, але ви можете об'єднати декілька (<bbb><aaa>), якщо один теґ (<aaa>) слід брати до уваги, лише якщо він перебуває усередині іншого теґу (<bbb>).

break-pi

Типово, команди обробки (тобто теґи "<? ... ?">) обробляються як вбудовані теґи. Передайте цей параметр, якщо ви хочете, щоб ці команди обробки оброблялися як теґи, які розривають повідомлення. Зауважте, що обробник використовує категорію команд обробки для необроблених теґів PHP.

nodefault

Список відокремлених пробілами теґів, які модуль не повинен типово встановлювати у будь-якій категорії.

Якщо у вашому тексті є теґ, для якого передбачено типові параметри обробки у підкласі цього модуля, ви можете змінити параметри. Для цього вам слід вказати теґ як частину рядка параметра nodefault.

cpp

Підтримка директив попередньої обробки C. Якщо встановлено цей параметр, po4a вважатиме директиви попередньої обробки роздільниками абзаців. Це важливо, якщо файл XML має бути попередньо оброблено, оскільки, якщо цього не зробити, директиви може бути вставлено у рядки, якщо po4a вважатиме їх належними до поточного абзацу, а отже, вставлені директиви може бути не розпізнано засобом попередньої обробки. Зауваження: директиви попередньої обробки мають з'являтися лише між теґами (вони не повинні порушувати послідовність теґів).

translated

Список відокремлених пробілами теґів, вміст яких ви хочете перекладати.

Теґи слід вказувати у форматі <aaa>, але ви можете об'єднати декілька (<bbb><aaa>), якщо один теґ (<aaa>) слід брати до уваги, лише якщо він перебуває усередині іншого теґу (<bbb>).

Ви також можете вказати деякі параметри теґів, додаючи символи перед ієрархією теґів. Ці параметри перевизначають типову поведінку, вказану за допомогою загальних параметрів wrap і defaulttranslateoption.

  * Для теґів зі списку B<break> встановлюється I<w> або I<W>, залежно від значення параметра <wrap>.
  * Для теґів зі списку B<inline> встановлюється I<i>.
  * Для теґів зі списку B<placeholder> встановлюється I<p>.
  * Для теґів зі списку B<untranslated> знімаються усі ці встановлені параметри.

untranslated

Список відокремлених пробілами теґів, вміст яких ви не хочете перекладати.

Теґи слід вказувати у форматі <aaa>, але ви можете об'єднати декілька (<bbb><aaa>), якщо один теґ (<aaa>) слід брати до уваги, лише якщо він перебуває усередині іншого теґу (<bbb>).

Будь ласка, зауважте, що придатний до перекладу вбудований теґ у даних теґу, який не перекладається, вважається теґом зміни режиму перекладу, параметр i скидається, і використовується параметр w або W, залежно від значення параметра <wrap>.

defaulttranslateoption

Типові категорії для теґів, які не належать до категорій translated, untranslated, break, inline або placeholder.

Це набір літер, які визначено у translated. Цей параметр є чинним лише для теґів, які можна перекладати.

НАПИСАННЯ ПОХІДНИХ МОДУЛІВ¶

  $self->{options}{'new_option'}='';
  $self->SUPER::initialize(%options);
  $self->{options}{'_default_translated'}.=' <p> <head><title>';
  $self->{options}{'attributes'}.=' <p>lang id';
  $self->{options}{'_default_inline'}.=' <br>';
  $self->treat_options;

  sub found_string {
    my ($self,$text,$ref,$options)=@_;
    $text = $self->translate($text,$ref,"type ".$options->{'type'},
      'wrap'=>$self->{options}{'wrap'});
    return $text;
  }

ВНУТРІШНІ ФУНКЦІЇ, які використовуються для написання похідних обробників¶

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

Цей модуль може перекладати теґи і атрибути.

СПИСОК ЗАВДАНЬ¶

DOCTYPE (ЗАПИСИ)

Передбачено мінімальну підтримку перекладу замінників. Вони перекладаються як ціле, теґи не беруться до уваги. Підтримки багаторядкових замінників не передбачено, замінники завжди переносяться під час перекладу.

ВНЕСЕННЯ ЗМІН ДО ТИПІВ ТЕҐІВ З УСПАДКОВАНИХ МОДУЛІВ (пересунути структуру tag_types до $self hash?)

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

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

АВТОРИ¶

 © Jordi Vilalta <jvprat@gmail.com>
 © Nicolas François <nicolas.francois@centraliens.net>

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

 © Jordi Vilalta  <jvprat@gmail.com>, 2004
 © Nicolas François <nicolas.francois@centraliens.net>, 2008—2009

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