Constructor¶

process(%)

Această funcție poate face tot ce aveți nevoie să faceți cu un document po4a într-o singură invocare. Argumentele sale trebuie să fie împachetate ca o serie de elemente asociative. ACȚIUNI:

new(%)

Creează un nou document po4a. Opțiuni acceptate (în seria de elemente asociative trecută ca parametru):

Manipularea fișierelor de documente¶

read($$$)

Adaugă un alt document de intrare de date la sfârșitul matricei existente "@{$self->{TT}{doc_in}}".

Această funcție are două argumente obligatorii și unul opțional.
* Numele fișierului care urmează să fie citit pe disc;
* Numele care trebuie utilizat ca nume de fișier la construirea referinței în fișierul PO;
* Setul de caractere care trebuie utilizat pentru a citi fișierul respectiv (UTF-8 în mod implicit)

Această matrice "@{$self->{TT}{doc_in}}" conține datele acestui document de intrare
ca o matrice de șiruri de caractere cu semnificații alternante.
* Șirul $textline conține fiecare linie a datelor text de intrare.
* Șirul "$filename:$linenum" conține locația acestuia și se numește
„referință” ("linenum" începe cu 1).

Vă rugăm să rețineți că aceasta nu analizează nimic. Ar trebui să utilizați funcția parse() atunci când ați terminat cu împachetarea fișierelor de intrare în document.

write($)

Scrie documentul tradus în fișierul specificat.

Aceste date de document traduse sunt furnizate de:
* "$self->docheader()" care conține textul antetului pentru modul și
* "@{$self->{TT}{doc_out}}" care conține fiecare linie a textului principal tradus în matrice.

Manipularea fișierelor PO¶

readpo($)

Adaugă conținutul unui fișier (al cărui nume este trecut ca argument) la PO de intrare existent. Conținutul vechi nu este eliminat.

writepo($)

Scrie fișierul PO extras la numele de fișier dat.

stats()

Returnează câteva statistici despre traducerea efectuată până în prezent. Vă rugăm să rețineți că nu sunt aceleași statistici ca cele afișate de «msgfmt --statistic». Aici, este vorba de statistici despre utilizarea recentă a fișierului PO, în timp ce «msgfmt» raportează starea fișierului. Este o funcție de învăluire pentru funcția Locale::Po4a::Po::stats_get aplicată la fișierul PO de intrare. Exemplu de utilizare:

    [utilizarea normală a documentului po4a...]
    ($percent,$hit,$queries) = $document->stats();
    print "Am găsit traduceri pentru $percent\% ($hit din $queries) de șiruri.\n";
    

Manipularea addendelor¶

addendum($)

Vă rugăm să consultați po4a(7) pentru mai multe informații despre ce sunt addendele și cum ar trebui să le scrie traducătorii. Pentru a aplica un addendum documentului tradus, pur și simplu treceți numele său de fișier la această funcție și ați terminat ;)

Această funcție returnează un număr întreg nenul în caz de eroare.

Obținerea intrărilor, furnizarea ieșirilor¶

Sunt furnizate patru funcții pentru a obține intrare și a returna ieșire. Acestea sunt foarte asemănătoare cu shift/unshift și push/pop din Perl.

 * Perl shift returnează primul element din matrice și îl elimină din matrice.
 * Perl unshift antepune un element în matrice ca primul element din matrice.
 * Perl pop returnează ultimul element al matricei și îl elimină din matrice.
 * Perl push adaugă un element în matrice ca ultim element al matricei.

Prima pereche este despre intrare, în timp ce a doua este despre ieșire. Mnemonic: la intrare, sunteți interesat de prima linie, ceea ce oferă shift(), iar la ieșire doriți să adăugați rezultatul la sfârșit, așa cum face push().

shiftline()

Această funcție returnează prima linie care urmează să fie analizată și referința corespunzătoare (împachetată ca o matrice) din matricea "@{$self->{TT}{doc_in}}" și elimină aceste prime două elemente ale matricei. Aici, referința este furnizată de un șir "$filename:$linenum".

unshiftline($$)

Deplasează ultima linie deplasată a documentului de intrare și referința corespunzătoare înapoi la începutul "{$self->{TT}{doc_in}}".

pushline($)

Introduce o linie nouă la sfârșitul "{$self->{TT}{doc_out}}".

popline()

Extrage ultima linie introdusă de la sfârșitul "{$self->{TT}{doc_out}}".

Marcarea șirurilor de caractere ca traductibile¶

O funcție este furnizată pentru a gestiona textul care trebuie tradus.

translate($$$)

Argumente obligatorii:

  $self->translate("string","ref","type",
                   'wrap' => 1);

Diverse funcții¶

verbose()

Returnează dacă opțiunea „verbose” (de detaliere a informațiilor) a fost trecută în timpul creării TransTractor.

debug()

Returnează dacă opțiunea „debug” (de depanare) a fost trecută în timpul creării TransTractor.

get_in_charset()

Această funcție returnează setul de caractere care a fost furnizat ca set de caractere principal

get_out_charset()

Această funcție va returna setul de caractere care trebuie utilizat în documentul de ieșire (de obicei util pentru a înlocui setul de caractere detectat în documentul de intrare, în cazul în care acesta a fost găsit).

Aceasta va utiliza setul de caractere de ieșire specificat în linia de comandă. Dacă nu a fost specificat, va utiliza setul de caractere al PO de intrare, iar dacă PO de intrare are valoarea implicită „CHARSET”, va returna setul de caractere al documentului de intrare, astfel încât să nu fie efectuată nicio codificare.