ИМЕ¶

Locale::Po4a::Xml - двосмерна конверзија XML (и изведених из њега) докумената и PO фајлова

ОПИС¶

Циљ po4a (PO for anything – PO за било шта) пројекта је да поједностави превођење (и што је још интересантније, одржавање превода) употребом gettext алата на деловима на којима се не очекује њихова употреба, као што је документација.

Locale::Po4a::Xml је модул који помаже превод XML докумената на друге [људске] језике. Такође може да се употреби и као основа за изградњу модула који обрађују документе базиране на XML.

ПРЕВОЂЕЊЕ ПОМОЋУ PO4A::XML¶

Овај модул може да се користи за директну обраду генеричких XML докумената. Издвојиће сав садржај ознаке, без атрибута, јер је ро место на коме се пише текст у већини докумената базираних на XML.

Постоје неке опције (описане у наредном одељку) које могу да прилагоде ово понашање. Ако се не уклапа у формат вашег документа, најбоље је да напишете ваш сопствени модул изведен из овога, који ће да опише детаље вашег формата. Да сазнате више о том процесу, погледајте одељак ПИСАЊЕ ИЗВЕДЕНИХ МОДУЛА испод.

ОПЦИЈЕ КОЈЕ ПРИХВАТА ОВАЈ МОДУЛ¶

Глобална дибаг опција чини да овај модул прикаже искључене стрингове, како би се видело ако прескаче нешто важно.

Ово су опције везане само за овај модул:

nostrip

Спречава да модул уклони размаке око издвојених стрингова.

wrap

Каноникализује стринг који се преводи, сматрајући да празни карактери нису битни и обавија преведени документ. Ова опција може да се преиначи прилагођеним опцијама за ознаке. Погледајте опцију translated ниже.

unwrap_attributes

Атрибути се подразумевано обвијају. Ова опција искључује обавијање.

caseinsensitive

Чини да претрага ознака и атрибута не прави разлику између малих и великих слова. Ако је дефинисана, третираће <BooK>laNG and <BOOK>Lang као <book>lang.

escapequotes

Означава знаке навода у излазним стринговима. Неопходно је, на пример, код креирања стринг ресурса које користе Андроид алати за изградњу апликација.

Погледајте такође: 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 (wrap - обавијај) или 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.

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 хеша?)

ПОГЛЕДАЈТЕ ТАКОЂЕ¶

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

АУТОРИ¶

 Жорди Вилалта<jvprat@gmail.com>
 Никола Франсоа <nicolas.francois@centraliens.net>

ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА¶

 Права умножавања © 2004 Жорди Вилалта <jvprat@gmail.com>
 Права умножавања © 2008-2009 Никола Франсоа <nicolas.francois@centraliens.net>

Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате под условима GPL v2.0 или новије (погледајте фајл COPYING).