NOME¶

Locale::Po4a::Xml - converte documenti XML e derivati da/verso file PO

DESCRIZIONE¶

L'obiettivo del progetto po4a (PO per tutto) è di facilitare le traduzioni (e cosa più interessante, la manutenzione delle traduzioni) usando gli strumenti associati a gettext in aree inaspettate come la documentazione.

Locale::Po4a::Xml è un modulo che aiuta la traduzione in altre lingue della documentazione in formato XML. Può anche essere usato come base per scrivere moduli per documenti basati su XML.

TRADURRE CON PO4A::XML¶

Questo modulo può essere utilizzato direttamente per gestire documenti XML generici. Estrarrà tutto il contenuto del tag e nessun attributo, poiché è lì che viene scritto il testo nella gran parte dei documenti basati su XML.

Ci sono alcune opzioni (descritte nella sezione successiva) che possono personalizzare questo comportamento. Se questo non dovesse adattarsi sufficientemente al formato del proprio documento si incoraggia a scriverne uno per il proprio modulo derivandolo da questo, per descrivere i dettagli del proprio formato. Consultare la prossima sezione SCRIVERE MODULI DERIVATI più sotto, per la descrizione del processo.

OPZIONI ACCETTATE DA QUESTO MODULO¶

L'opzione di debug globale fa sì che questo modulo mostri le stringhe escluse, per vedere se salta qualcosa di importante.

Queste sono le opzioni speciali per questo modulo:

nostrip

Previene la rimozione degli spazi attorno alle stringhe estratte.

wrap

Canonizza la stringa da tradurre, considerando che gli spazi bianchi non siano importanti, e formatta il documento tradotto. Questa opzione può essere superata da opzioni tag personalizzate. Vedere l'opzione translated sotto.

unwrap_attributes

Gli attributi vengono formattati per impostazione predefinita. Questa opzione disabilita la formattazione.

caseinsensitive

Fa in modo che la ricerca di tag e attributi funzioni senza distinzione tra maiuscole e minuscole. Se è definito, tratterà <Book>laNG ed <BOOK>Lang come <book>lang.

escapequotes

Virgolette di escape nelle stringhe in uscita. Necessario, ad esempio, per creare risorse stringa da utilizzare con gli strumenti di build Android.

Vedere anche: https://developer.android.com/guide/topics/resources/string-resource.html

includeexternal

Se definite, le entità esterne verranno incluse nel documento generato (tradotto) e per l'estrazione delle stringhe. Se non è definito, si dovrà tradurre gli elementi esterni separatamente come documenti indipendenti.

ontagerror

Questa opzione definisce il comportamento del modulo quando incontra una sintassi XML non valida (un tag di chiusura che non corrisponde all'ultimo tag di apertura). Può assumere i seguenti valori:

tagsonly

Nota: questa opzione è sconsigliata.

Estrae solo i tag specificati nell'opzione tags. Altrimenti, estrarrà tutti i tag tranne quelli specificati.

doctype

Stringa di cui verrà verificata la corrispondenza con la prima riga del doctype del documento (se definito). Nel caso non corrisponda, un avviso indicherà che il documento potrebbe essere di tipo non valido.

addlang

Stringa indicante il percorso (es. <bbb><aaa>) di un tag a cui deve essere aggiunto un attributo lang="...". La lingua sarà definita come il nome di base del file PO senza alcuna estensione .po.

optionalclosingtag

Valore booleano indicante se i tag di chiusura sono facoltativi (come in HTML). Per impostazione predefinita, i tag di chiusura mancanti generano un errore gestito secondo ontagerror.

tags

Nota: questa opzione è sconsigliata. In alternativa si consiglia di usare le opzioni translated e untranslated.

Elenco separato da spazi di tag che si vuole tradurre o saltare. Per impostazione predefinita, i tag specificati verranno esclusi, ma se si usa l'opzione "tagsonly", i tag specificati saranno gli unici inclusi. I tag devono essere nella forma <aaa>, ma si può unirne alcuni (<bbb><aaa>) per dire che il contenuto del tag <aaa> verrà tradotto solo quando è in un tag <bbb>.

Si può anche specificare alcune opzioni di tag inserendo alcuni caratteri davanti alla gerarchia dei tag. Ad esempio, si può inserire w (a capo) o W (non a capo) per sovrascrivere il comportamento predefinito specificato dall'opzione globale wrap.

Esempio: W<chapter><title>

attributes

Elenco separato da spazi di attributi del tag che si desidera tradurre. Si può specificare gli attributi in base al loro nome (ad esempio, "lang"), ma si può anche anteporre una gerarchia di tag, per specificare che questo attributo verrà tradotto solo quando si trova nel tag specificato. Ad esempio: <bbb><aaa>lang specifica che l'attributo lang verrà tradotto solo se si trova in un tag <aaa> in un tag <bbb>.

foldattributes

Non tradurre gli attributi nei tag in linea. Invece, sostituisci tutti gli attributi di un tag con po4a-id=<id>.

Utile quando gli attributi non devono essere tradotti, poiché semplifica le stringhe per i traduttori ed evita errori di battitura.

customtag

Elenco separato da spazi di tag che non devono essere trattati come tag. Questi tag sono trattati come in linea e non devono essere chiusi.

break

Elenco separato da spazi di tag che dovrebbero interrompere la sequenza. Per impostazione predefinita, tutti i tag interrompono la sequenza.

I tag devono essere nella forma <aaa>, ma si possono unire ad altri, ad esempio (<bbb><aaa>), se il tag (<aaa>) deve essere considerato solo quando si trova all'interno di un altro tag (<bbb>).

Tenere presente che un tag deve essere elencato solo in una delle stringhe di impostazione break, inline placeholder o customtag.

inline

Elenco separato da spazi di tag che devono essere trattati come in linea. Per impostazione predefinita, tutti i tag interrompono la sequenza.

I tag devono essere nella forma <aaa>, ma si possono unire ad altri, ad esempio (<bbb><aaa>), se il tag (<aaa>) deve essere considerato solo quando si trova all'interno di un altro tag (<bbb>).

placeholder

Elenco separato da spazi di tag che devono essere trattati come segnaposto. I segnaposto non interrompono la sequenza, ma il contenuto dei segnaposto viene tradotto separatamente.

La posizione del segnaposto nel suo blocco sarà contrassegnata da una stringa simile a:

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

I tag devono essere nella forma <aaa>, ma si possono unire ad altri, ad esempio (<bbb><aaa>), se il tag (<aaa>) deve essere considerato solo quando si trova all'interno di un altro tag (<bbb>).

break-pi

Per impostazione predefinita, le istruzioni di elaborazione (ovvero i tag "<? ... ?>") vengono gestite come tag in linea. Passare questa opzione se si vuole che il PI venga gestito come tag di rottura. Si noti che i tag PHP non elaborati vengono gestiti come istruzioni di elaborazione dall'analizzatore.

nodefault

Elenco di tag separati da spazi che il modulo non dovrebbe provare a impostare per impostazione predefinita in nessuna categoria.

Se si ha un tag che ha la sua impostazione predefinita dalla sottoclasse di questo modulo ma si vuole impostare un'impostazione alternativa, si deve elencare quel tag come parte della stringa di impostazione nodefault.

cpp

Supporta le direttive del preprocessore C. Quando questa opzione è impostata, po4a considererà le direttive del preprocessore come separatori di paragrafo. Ciò è importante se il file XML deve essere preprocessato perché altrimenti le direttive potrebbero essere inserite in mezzo alle righe, se po4a le considerasse appartenenti al paragrafo corrente, e quindi non verrebbero riconosciute dal preprocessore. Nota: le direttive del preprocessore devono apparire solo tra i tag (non devono interrompere un tag).

translated

Elenco separato da spazi di marcatori che si intende tradurre.

I tag devono essere nella forma <aaa>, ma si possono unire ad altri, ad esempio (<bbb><aaa>), se il tag (<aaa>) deve essere considerato solo quando si trova all'interno di un altro tag (<bbb>).

Si può inoltre specificare alcune opzioni di tag, inserendo alcuni caratteri davanti alla gerarchia dei tag. Ciò supera il comportamento predefinito specificato dalle opzioni globali wrap e defaulttranslateoption.

untranslated

Elenco separato da spazi di marcatori che non si intende tradurre.

I tag devono essere nella forma <aaa>, ma si possono unire ad altri, ad esempio (<bbb><aaa>), se il tag (<aaa>) deve essere considerato solo quando si trova all'interno di un altro tag (<bbb>).

Si noti che un tag in linea traducibile in un tag non tradotto viene trattato come un tag di rottura traducibile, l'impostazione i viene eliminata e w o W viene impostato a seconda dell'opzione wrap.

defaulttranslateoption

Le categorie predefinite, per i tag che non fanno parte di translated, untranslated, break, inline o placeholder.

È un insieme di lettere come definito in translated e questa impostazione è valida solo per i tag traducibili.

SCRIVERE MODULI DERIVATI¶

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

FUNZIONI INTERNE usate per scrivere parser derivati¶

STATO DI QUESTO MODULO¶

Questo modulo può tradurre tag e attributi.

ELENCO DEI DAFARE¶

TIPO DI DOCUMENTO (ENTITÀ)

C'è un supporto minimo per la traduzione di entità. Vengono tradotte in un blocco e i tag non vengono presi in considerazione. Le entità multilinea non sono supportate; le entità vengono sempre riformattate durante la traduzione.

MODIFICA I TIPI DI TAG DAI MODULI EREDITATI (sposta la struttura tag_types all'interno dell'hash $self?)

VEDERE ANCHE¶

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

AUTORI¶

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

TRADUZIONE¶

 Danilo Piazzalunga <danilopiazza@libero.it>
 Marco Ciampa <ciampix@posteo.net>

COPYRIGHT E LICENZA¶

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

Questo programma è software libero; è lecito ridistribuirlo o modificarlo secondo i termini della licenza GPL v2.0 o successive (vedere il file COPYING).