LOCALE::PO4A::PO.3PM(1)                    User Contributed Perl Documentation


NUME
       Locale::Po4a::Po - modul de manipulare a fi<?>ierelor PO

SINOPSIS
           use Locale::Po4a::Po;
           my $pofile=Locale::Po4a::Po->new();

           # Cite<?>te fi<?>ierul PO
           $pofile->read('fi<?>ier.po');

           # Adauga o intrare
           $pofile->push('msgid' => 'Hello', 'msgstr' => 'Salut',
                         'flags' => "wrap", 'reference'=>'file.c:46');

           # Extrage o traducere
           $pofile->gettext("Hello"); # returneaza 'Salut'

           # Scrie inapoi intr-un fi<?>ier
           $pofile->write('alt-fi<?>ier.po');

DESCRIERE
       Locale::Po4a::Po este un modul care va permite sa manipula<?>i
       cataloagele de mesaje. Pute<?>i incarca <?>i scrie din/intr-un fi<?>ier
       (a carui extensie este adesea po), pute<?>i construi noi intrari din
       mers sau solicita traducerea unui <?>ir de caractere.

       Pentru o descriere mai completa a cataloagelor de mesaje in format PO
       <?>i a utilizarii acestora, consulta<?>i documenta<?>ia info a
       programului gettext (nodul ,,`PO Files"').

       Acest modul face parte din proiectul po4a, al carui obiectiv este de a
       utiliza fi<?>ierele PO (concepute la origine pentru a facilita
       traducerea mesajelor de program) pentru a traduce totul, inclusiv
       documenta<?>ia (pagina man, manualul info), descrierea pachetului,
       <?>abloanele debconf <?>i tot ceea ce se poate beneficia de acest
       lucru.

OP<?>IUNI ACCEPTATE DE ACEST MODUL
       --porefs tip
           Specifica formatul referin<?>ei. Argumentul tip poate fi unul
           dintre never pentru a nu produce nicio referin<?>a, file pentru a
           specifica doar fi<?>ierul fara numarul de linie, counter pentru a
           inlocui numarul de linie cu un contor crescator <?>i full pentru a
           include referin<?>e complete (implicit: full).

       --wrap-po no|newlines|numar (implicit: 76)
           Specifica modul in care liniile din fi<?>ierul po ar trebui sa fie
           incadrate. Acest lucru ofera posibilitatea de a alege intre
           fi<?>iere care sunt bine ajustate ca incadrare, dar ar putea duce
           la conflicte git, sau fi<?>iere care sunt mai u<?>or de gestionat
           automat, dar mai greu de citit pentru oameni.

           Din punct de vedere istoric, suita gettext a reformatat fi<?>ierele
           po la a 77-a coloana pentru cosmetica. Aceasta op<?>iune specifica
           comportamentul lui po4a. Daca este definita la o valoare numerica,
           po4a va impacheta fi<?>ierul po dupa aceasta coloana <?>i dupa
           noile linii din con<?>inut. Daca este definita la newlines, po4a va
           impar<?>i doar msgid <?>i msgstr dupa linii noi din con<?>inut.
           Daca este definita la no, po4a nu va incadra deloc fi<?>ierul po.
           Comentariile de referin<?>a sunt intotdeauna incadrate de
           instrumentele gettext pe care le folosim intern.

           Re<?>ine<?>i ca aceasta op<?>iune nu are niciun impact asupra
           modului in care msgid <?>i msgstr sunt incadrate, adica asupra
           modului in care sunt adaugate linii noi la con<?>inutul acestor
           <?>iruri.

       --msgid-bugs-address adresa@po<?>ta.electronica
           Define<?>te adresa de raportare pentru erori din msgid. In mod
           implicit, fi<?>ierele POT create nu au campuri
           Report-Msgid-Bugs-To.

       --copyright-holder <?>ir
           Define<?>te de<?>inatorul drepturilor de autor in antetul POT.
           Valoarea implicita este ,,Free Software Foundation, Inc."

       --package-name <?>ir
           Define<?>te numele pachetului pentru antetul POT. Valoarea
           implicita este ,,PACKAGE".

       --package-version <?>ir
           Define<?>te versiunea pachetului pentru antetul POT. Valoarea
           implicita este ,,VERSION".

Func<?>ii privind cataloage intregi de mesaje
       new()
           Creeaza un nou catalog de mesaje. Daca este furnizat un argument,
           acesta este numele unui fi<?>ier PO pe care ar trebui sa il
           incarcam.

       read($)
           Cite<?>te un fi<?>ier PO (al carui nume este dat ca argument).
           Intrarile existente anterior in acesta nu sunt eliminate, cele noi
           sunt adaugate la sfar<?>itul catalogului.

       write($)
           Scrie catalogul curent in fi<?>ierul dat.

       write_if_needed($$)
           Precum ,,write($)", dar daca fi<?>ierul PO sau POT exista deja,
           obiectul va fi scris intr-un fi<?>ier temporar care va fi comparat
           cu fi<?>ierul existent pentru a verifica daca actualizarea este
           necesara (astfel se evita modificarea unui POT doar pentru a
           actualiza o referin<?>a de linie sau campul POT-Creation-Date).

       filter($)
           Aceasta func<?>ie extrage un catalog dintr-unul existent. Doar
           intrarile care au o referin<?>a in fi<?>ierul dat vor fi plasate in
           catalogul rezultat.

           Aceasta func<?>ie analizeaza argumentul sau, il converte<?>te
           intr-o defini<?>ie de func<?>ie Perl, verifica aceasta defini<?>ie
           <?>i filtreaza campurile pentru care aceasta func<?>ie returneaza
           ,,true".

           Iubesc Perl uneori ;)

Func<?>ii pentru utilizarea unui catalog de mesaje pentru traduceri
       gettext($%)
           Solicita traducerea <?>irului de caractere dat ca argument in
           catalogul curent. Func<?>ia returneaza <?>irul original (netradus)
           daca <?>irul nu a fost gasit.

           Dupa <?>irul de caractere de tradus, pute<?>i trece o serie de
           argumente suplimentare. Iata intrarile valide:

           wrap
               argument boolean care indica daca putem considera ca spa<?>iile
               albe din <?>ir nu sunt importante. Daca da, func<?>ia
               canonizeaza <?>irul inainte de a cauta o traducere <?>i
               incadreaza rezultatul.

           wrapcol
               coloana la care ar trebui sa se faca incadrarea (implicit: 76).

       stats_get()
           Returneaza statistici despre rata de succes a gettext de la ultima
           data cand a fost apelat stats_clear(). Va rugam sa re<?>ine<?>i ca
           nu este vorba de acelea<?>i statistici ca cele afi<?>ate de msgfmt
           --statistic. Aici, este vorba de statistici despre utilizarea
           recenta a fi<?>ierului PO, in timp ce msgfmt raporteaza starea
           fi<?>ierului. Exemplu de utilizare:

               [unele utilizari ale fi<?>ierului PO pentru a traduce lucruri]

               ($percent,$hit,$queries) = $pofile->stats_get();
               print "Pana acum, am gasit traduceri pentru $percent\% ($hit din $queries) de <?>iruri.\n";

       stats_clear()
           <?>terge statisticile privind rezultatele (gasirile de <?>iruri)
           gettext.

Func<?>ii pentru a construi un catalog de mesaje
       push(%)
           Introduce o noua intrare la sfar<?>itul catalogului curent.
           Argumentele trebuie sa formeze un tabel de elemente asociative.
           Cheile valide sunt:

           msgid
               <?>irul de caractere in limba originala.

           msgstr
               traducerea.

           reference
               o indica<?>ie a locului in care a fost gasit acest <?>ir de
               caractere. Exemplu: file.c:46 (adica in ,,file.c" la linia 46).
               Poate fi o lista separata prin spa<?>ii in cazul ocuren<?>elor
               multiple.

           comment
               un comentariu adaugat aici manual (de catre traducatori).
               Formatul acestuia este liber.

           automatic
               un comentariu care a fost adaugat automat de programul de
               extragere a <?>irurilor de caractere. Consulta<?>i op<?>iunea
               --add-comments a programului xgettext pentru mai multe
               informa<?>ii.

           flags
               lista separata prin spa<?>ii a tuturor fanioanelor definite
               pentru aceasta intrare.

               Fanioanele valide sunt: c-text, python-text, lisp-text,
               elisp-text, librep-text, smalltalk-text, java-text, awk-text,
               object-pascal-text, ycp-text, tcl-text, wrap, no-wrap <?>i
               fuzzy.

               Consulta<?>i documenta<?>ia gettext pentru semnifica<?>ia
               acestora.

           type
               acesta este in principal un argument intern: este utilizat in
               timpul gettextizarii documentelor. Ideea aici este de a analiza
               atat originalul, cat <?>i traducerea intr-un obiect PO <?>i de
               a le uni, folosind msgid-ul unuia ca msgid <?>i msgid-ul
               celuilalt ca msgstr. Pentru a ne asigura ca lucrurile merg
               bine, fiecarui msgid din obiectele PO i se atribuie un tip,
               bazat pe structura lor (precum ,,chapt", ,,sect1", ,,p" <?>i
               a<?>a mai departe in DocBook). Daca tipurile de <?>iruri de
               caractere nu sunt identice, inseamna ca ambele fi<?>iere nu au
               aceea<?>i structura, iar procesul raporteaza o eroare.

               Aceste informa<?>ii sunt scrise ca un comentariu automat in
               fi<?>ierul PO, deoarece ofera traducatorilor un anumit context
               cu privire la <?>irurile de caractere de tradus.

           wrap
               boolean care indica daca spa<?>iile albe pot fi manipulate in
               reformatarile cosmetice. Daca este adevarat, <?>irul este
               canonizat inainte de utilizare.

               Aceste informa<?>ii sunt scrise in fi<?>ierul PO cu ajutorul
               fanionului wrap sau no-wrap.

           wrapcol
               ignorat; cheia este pastrata pentru compatibilitatea cu
               versiunile anterioare.

Func<?>ii diverse
       count_entries()
           Returneaza numarul de intrari din catalog (fara antet).

       count_entries_doc()
           Returneaza numarul de intrari din document. Daca un <?>ir de
           caractere apare de mai multe ori in document, acesta va fi numarat
           de mai multe ori.

       msgid($)
           Returneaza msgid-ul numarului dat.

       msgid_doc($)
           Returneaza msgid-ul cu pozi<?>ia data in document.

       type_doc($)
           Returneaza tipul msgidului cu pozi<?>ia data in document. Acest
           lucru este probabil util doar pentru gettextizare <?>i este stocat
           separat de {$msgid}{'type'} deoarece loca<?>ia ulterioara poate fi
           suprascrisa de un alt tip atunci cand $msgid este duplicat in
           documentul principal.

       get_charset()
           Returneaza setul de caractere specificat in antetul PO. Daca nu a
           fost definit, se va returna ,,UTF-8".

AUTORI
        Denis Barbier <barbier@linuxfr.org>
        Martin Quinson (mquinson#debian.org)

perl v5.42.0                      2025-11-22           LOCALE::PO4A::PO.3PM(1)