NUME¶

Locale::Po4a::Xml - convertește documente XML și derivate din/în fișiere PO

DESCRIERE¶

Scopul proiectului po4a (PO pentru orice) este de a ușura traducerile (și mai interesant, întreținerea traducerilor) folosind instrumente gettext în domenii în care nu erau așteptate, cum ar fi documentația.

Locale::Po4a::Xml este un modul care ajută la traducerea documentelor XML în alte limbi [umane]. De asemenea, poate fi folosit ca bază pentru a construi module pentru documente bazate pe XML.

TRADUCEREA CU PO4A::XML¶

Acest modul poate fi utilizat direct pentru a gestiona documente XML generice. Acesta va extrage tot conținutul etichetei, fără atribute, deoarece acesta este locul în care este scris textul în majoritatea documentelor bazate pe XML.

Există câteva opțiuni (descrise în secțiunea următoare) care pot personaliza acest comportament. În cazul în care acest lucru nu se potrivește cu formatul documentului dvs., sunteți încurajat să scrieți propriul dvs. modul derivat din acesta, pentru a descrie detaliile formatului dvs. Pentru descrierea procesului, consultați secțiunea SCRIEREA MODULELOR DERIVATE de mai jos.

OPȚIUNI ACCEPTATE DE ACEST MODUL¶

Opțiunea globală de depanare face ca acest modul să afișeze șirurile excluse, pentru a vedea dacă sare peste ceva important.

Acestea sunt opțiunile particulare ale acestui modul:

nostrip

Îl împiedică să elimine spațiile din jurul șirurilor extrase.

wrap

Canonizează șirul de caractere de tradus, considerând că spațiile albe nu sunt importante, și încadrează documentul tradus. Această opțiune poate fi anulată prin opțiuni de etichetă personalizate. A se vedea opțiunea translated de mai jos.

unwrap_attributes

Atributele sunt învăluite în mod implicit. Această opțiune dezactivează învăluirea.

caseinsensitive

Aceasta face ca etichetele și atributele de căutare să funcționeze în mod insensibil la majuscule. Dacă este definită, va trata <BooK>laNG și <BOOK>Lang ca <book>lang.

escapequotes

Eludează ghilimelele din șirurile de ieșire. Necesar, de exemplu, pentru crearea resurselor de șiruri de caractere pentru a fi utilizate de instrumentele de compilare Android.

A se vedea și: https://developer.android.com/guide/topics/resources/string-resource.html

includeexternal

Dacă este definită, entitățile externe sunt incluse în documentul generat (tradus) și pentru extragerea șirurilor de caractere. Dacă nu este definită, va trebui să traduceți entitățile externe separat, ca documente independente.

ontagerror

Această opțiune definește comportamentul modulului atunci când întâlnește o sintaxă XML nevalidă (o etichetă de închidere care nu se potrivește cu ultima etichetă de deschidere). Aceasta poate lua următoarele valori:

tagsonly

Notă: Această opțiune este depreciată.

Extrage numai etichetele specificate în opțiunea tags. În caz contrar, va extrage toate etichetele, cu excepția celor specificate.

doctype

Șir de caractere care va încerca să se potrivească cu prima linie a documentului doctype (dacă este definit). În caz contrar, un avertisment va indica faptul că documentul ar putea fi de un tip greșit.

addlang

Șir ce indică ruta (de exemplu, <bbb><aaa>) unei etichete la care se adaugă un atribut lang=„...”. Limba va fi definită ca numele de bază al fișierului PO fără nicio extensie .po.

optionalclosingtag

Argument boolean care indică dacă etichetele de închidere sunt opționale (ca în HTML). În mod implicit, lipsa etichetelor de închidere generează o eroare tratată în conformitate cu ontagerror.

tags

Notă: Această opțiune este depreciată. Ar trebui să utilizați în schimb opțiunile translated și untranslated.

Listă separată prin spații a etichetelor pe care doriți să le traduceți sau să le omiteți. În mod implicit, etichetele specificate vor fi excluse, dar dacă utilizați opțiunea „tagsonly”, etichetele specificate vor fi singurele incluse. Etichetele trebuie să fie de forma <aaa>, dar puteți alătura unele (<bbb><aaa>) pentru a spune că conținutul etichetei <aaa> va fi tradus numai atunci când este într-o etichetă <bbb>.

De asemenea, puteți specifica unele opțiuni de etichetă prin introducerea unor caractere în fața ierarhiei etichetei. De exemplu, puteți pune w (wrap) sau W (don't wrap) pentru a trece peste comportamentul implicit specificat de opțiunea globală wrap.

Exemplu: W<capitolr><titlu>

attributes

Listă separată prin spații a atributelor etichetei pe care doriți să le traduceți. Puteți specifica atributele după numele lor (de exemplu, „lang”), dar le puteți prefixa cu o ierarhie a etichetei, pentru a specifica faptul că acest atribut va fi tradus numai atunci când se află în eticheta specificată. De exemplu: <bbb><aaa>lang specifică faptul că atributul lang va fi tradus numai dacă se află într-o etichetă <aaa>, și acesta se află într-o etichetă <bbb>.

foldattributes

Nu traduce atributele din etichetele inline. În schimb, înlocuiește toate atributele unui etichete cu po4a-id=<id>.

Acest lucru este util atunci când atributele nu trebuie traduse, deoarece simplifică șirurile pentru traducători și evită greșelile de scriere.

customtag

Listă de etichete separate prin spații care nu ar trebui tratate ca etichete. Aceste etichete sunt tratate ca inline și nu trebuie să fie închise.

break

Lista de etichete separate prin spații care ar trebui să întrerupă secvența. În mod implicit, toate etichetele întrerup secvența.

Etichetele trebuie să fie sub forma <aaa>, dar puteți alătura unele (<bbb><aaa>), dacă o etichetă (<aaa>) ar trebui să fie luată în considerare numai atunci când este în interiorul unei alte etichete (<bbb>).

Vă rugăm să rețineți că o etichetă trebuie să fie listată într-un singur șir de definiții break, inline placeholder, sau customtag.

inline

Listă de etichete separate prin spațiu care ar trebui tratate ca fiind inline. În mod implicit, toate etichetele întrerup secvența.

Etichetele trebuie să fie sub forma <aaa>, dar puteți alătura unele (<bbb><aaa>), dacă o etichetă (<aaa>) ar trebui să fie luată în considerare numai atunci când este în interiorul unei alte etichete (<bbb>).

placeholder

Listă de etichete, separate prin spații, care ar trebui să fie tratate ca marcatori de poziție. Marcatorii de poziție nu întrerup secvența, dar conținutul acestora este tradus separat.

Locația marcatorului de poziție în blocul său va fi marcată cu un șir similar cu:

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

Etichetele trebuie să fie sub forma <aaa>, dar puteți alătura unele (<bbb><aaa>), dacă o etichetă (<aaa>) ar trebui să fie luată în considerare numai atunci când este în interiorul unei alte etichete (<bbb>).

break-pi

În mod implicit, instrucțiunile de procesare (de exemplu, etichetele "<? ... ?>") sunt tratate ca etichete inline. Treceți această opțiune dacă doriți ca PI să fie tratată ca o etichetă de întrerupere. Rețineți că etichetele PHP neprocesate sunt tratate ca Instrucțiuni de procesare de către analizatorul analitic.

nodefault

Listă de etichete separate prin spații pe care modulul nu ar trebui să încerce să le definească implicit în nicio categorie.

Dacă aveți o etichetă a cărei definiție implicită este stabilită de subclasa acestui modul, dar doriți să stabiliți o definiție alternativă, trebuie să listați eticheta respectivă ca parte a șirului de definiții nodefault.

cpp

Acceptă directivele preprocesorului C. Atunci când această opțiune este activată, po4a va considera directivele preprocesorului ca separatoare de paragraf. Acest lucru este important dacă fișierul XML trebuie preprocesat, deoarece în caz contrar directivele pot fi inserate în mijlocul liniilor dacă po4a consideră că aparțin paragrafului curent, iar acestea nu vor fi recunoscute de preprocesor. Notă: directivele preprocesorului trebuie să apară numai între etichete (ele nu trebuie să rupă o etichetă).

translated

Listă de etichete separate prin spații pe care doriți să le traduceți.

Etichetele trebuie să fie sub forma <aaa>, dar puteți alătura unele (<bbb><aaa>), dacă o etichetă (<aaa>) ar trebui să fie luată în considerare numai atunci când este în interiorul unei alte etichete (<bbb>).

De asemenea, puteți specifica unele opțiuni de etichetă prin introducerea unor caractere în fața ierarhiei etichetei. Aceasta înlocuiește comportamentul implicit specificat de opțiunea globală wrap și defaulttranslateoption.

untranslated

Listă de etichete separate prin spații pe care nu doriți să le traduceți.

Etichetele trebuie să fie sub forma <aaa>, dar puteți alătura unele (<bbb><aaa>), dacă o etichetă (<aaa>) ar trebui să fie luată în considerare numai atunci când este în interiorul unei alte etichete (<bbb>).

Vă rugăm să rețineți că o etichetă inline traductibilă într-o etichetă netradusă este tratată ca o etichetă de întrerupere traductibilă, opțiunea i este eliminată și w sau W este stabilită în funcție de opțiunea wrap.

defaulttranslateoption

Categoriile implicite pentru etichetele care nu sunt în niciuna dintre categoriile „translated”, „untranslated”, „break”, „inline” sau „placeholder”.

Acesta este un set de litere definit în translated și această opțiune este valabilă numai pentru etichetele traductibile.

SCRIEREA MODULELOR DERIVATE¶

  $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;
  }

FUNCȚII INTERNE utilizate pentru scrierea analizatorilor derivativi¶

STAREA ACESTUI MODUL¶

Acest modul poate traduce etichete și atribute.

LISTA CU LUCRURI DE FĂCUT¶

DOCTYPE (ENTITĂȚI)

Există un suport minim pentru traducerea entităților. Acestea sunt traduse ca un întreg, iar etichetele nu sunt luate în considerare. Entitățile multilinie nu sunt acceptate, iar entitățile sunt întotdeauna reîncadrate (redimensionate) în timpul traducerii.

MODIFICAREA TIPURILOR DE ETICHETE DIN MODULELE EREDATE (mutarea structurii tag_types în interiorul tabelului de elemente asociate $self?)

CONSULTAȚI ȘI¶

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

AUTORI¶

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

DREPTURI DE AUTOR și LICENȚö

 Drepturi de autor © 2004 Jordi Vilalta <jvprat@gmail.com>
 Drepturi de autor © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>

Acest program este software liber; îl puteți redistribui și/sau modifica în conformitate cu termenii GPL v2.0 sau o versiune ulterioară (consultați fișierul COPYING).