Constructor

process(%)

Aquesta funció pot fer tot el que necessiteu fer amb un document po4a en una única invocació. Els seus paràmetres han d'estar empaquetats com a un hash. ACCIONS:

new(%)

Create a new po4a document. Accepted options (in the hash passed as a parameter):

Manipulant fitxers de documentació

read($$)

Add another input document data at the end of the existing array "@{$self->{TT}{doc_in}}". The argument is the filename to read. If a second argument is provided, it is the filename to use in the references.

This array "@{$self->{TT}{doc_in}}" holds this input document data as an array of strings with alternating meanings.
* The string $textline holding each line of the input text data.
* The string "$filename:$linenum" holding its location and called as
"reference" ("linenum" starts with 1).

Tingueu en compte que això no analitza res. Haureu de cridar la funció parse() quan hagueu acabat d'empaquetar els fitxers d'entrada en el document.

write($)

Escriu el document traduït al fitxer amb el nom donat.

This translated document data are provided by:
* "$self->docheader()" holding the header text for the plugin, and
* "@{$self->{TT}{doc_out}}" holding each line of the main translated text in the array.

Manupulant fitxers PO

readpo($)

Afegeix el contingut d'un fitxer (el nom del qual s'ha de passar com a paràmetre) al PO d'entrada actual. No es descarta el contingut anterior.

writepo($)

Escriu el fitxer PO extret al fitxer amb el nom donat.

stats()

Retorna algunes estadístiques de la traducció feta fins al moment. Tingueu en compte que no són les mateixes estadístiques que mostra msgfmt --statistic. Aquestes són estadístiques sobre l'ús recent del fitxer PO, mentre que msgfmt mostra l'estat del fitxer. Simplement crida la funció Locale::Po4a::Po::stats_get sobre el fitxer PO d'entrada. Exemple d'ús:

    [ús normal del document po4a...]
    ($percentatge,$encerts,$peticions) = $document->stats();
    print "S'han trobat traduccions per al $percentatge\%  ($encerts de $peticions) de cadenes.\n";
    

Manipulant annexes

addendum($)

Consulteu po4a(7) per més informació sobre què són els annexes, i com els han d'escriure els traductors. Per tal d'aplicar un annex al document traduït, simplement passeu el nom del fitxer a aquesta funció i ja està ;)

Aquesta funció retorna un enter no nul en cas d'error.

Obtenint entrada, proporcionant sortida

Four functions are provided to get input and return output. They are very similar to shift/unshift and push/pop of Perl.

 * Perl shift returns the first array item and drop it from the array.
 * Perl unshift prepends an item to the array as the first array item.
 * Perl pop returns the last array item and drop it from the array.
 * Perl push appends an item to the array as the last array item.

The first pair is about input, while the second is about output. Mnemonic: in input, you are interested in the first line, what shift gives, and in output you want to add your result at the end, like push does.

shiftline()

This function returns the first line to be parsed and its corresponding reference (packed as an array) from the array "@{$self->{TT}{doc_in}}" and drop these first 2 array items. Here, the reference is provided by a string "$filename:$linenum".

unshiftline($$)

Unshifts the last shifted line of the input document and its corresponding reference back to the head of "{$self->{TT}{doc_in}}".

pushline($)

Push a new line to the end of "{$self->{TT}{doc_out}}".

popline()

Pop the last pushed line from the end of "{$self->{TT}{doc_out}}".

Marcant cadenes com a traduïbles

Es proporciona una funció per tractar el text que s'ha de traduir.

translate($$$)

Paràmetres obligatoris:

  $self->translate("cadena","ref","tipus",
                   'wrap' => 1);

Funcions diverses

verbose()

Retorna el nivell d'informació extra que es va passar durant la creació del TransTractor.

debug()

Retorna si s'ha passat l'opció de depuració durant la creació del TransTractor.

detected_charset($)

Això informa al TransTractor que s'ha detectat un nou joc de caracters (el primer paràmetre) del document d'entrada. Habitualment es pot trobar a la capçalera dels documents. Tan sols es mantindrà el primer joc de caracters trobat, ja sigui un paràmetre de process() o bé sigui detectat del document.

get_out_charset()

Aquesta funció retorna el joc de caràcters que s'ha d'utilitzar en el document de sortida (habitualment és útil per substituir el joc de caràcters del document d'entrada en el lloc on s'ha trobat).

Utilitzarà el joc de caràcters especificat a la línia de comandes. Si no s'ha especificat, utilitzarà el joc de caràcters del PO d'entrada, i si el PO d'entrada conté el valor per defecte "CHARSET", retornarà el joc de caràcters del document d'entrada, de forma que no es realitzi recodificació.

recode_skipped_text($)

Aquesta funció retorna el text passat com a paràmetre recodificat, des del joc de caràcters del document d'entrada cap al del document de sortida. Això no és necessari quan es tradueix una cadena (la funció translate() ja recodifica les traduccions), però és important quan se salta una cadena del document d'entrada i es vol conservar la consistència en la codificació global del document de sortida.