PO4A.1P(1)            User Contributed Perl Documentation           PO4A.1P(1)


NUME
       po4a - actualizeaza atat fi<?>ierele PO, cat <?>i documentele traduse
       dintr-o singura lovitura

SINOPSIS
       po4a [op<?>iuni] fi<?>ier-configurare

DESCRIERE
       po4a (PO pentru orice) faciliteaza intre<?>inerea traducerii
       documenta<?>iei utilizand instrumentele clasice gettext. Principala
       caracteristica a po4a este ca decupleaza traducerea con<?>inutului de
       structura documentului. Va rugam sa consulta<?>i pagina po4a(7) pentru
       o introducere u<?>oara in acest proiect.

       La execu<?>ie, po4a analizeaza toate fi<?>ierele de documenta<?>ie
       specificate in fi<?>ierul sau de configurare. Acesta actualizeaza
       fi<?>ierele PO (care con<?>in traducerea) pentru a reflecta orice
       modificare a documenta<?>iei <?>i produce o documenta<?>ie tradusa prin
       injectarea traducerii con<?>inutului (gasit in fi<?>ierele PO) in
       structura documentului principal original.

       La inceput, fi<?>ierele PO con<?>in doar <?>irurile care trebuie
       traduse din documenta<?>ia originala. Acest format de fi<?>ier permite
       traducatorilor sa furnizeze manual o traducere pentru fiecare paragraf
       extras de po4a. Daca documenta<?>ia este modificata dupa traducere,
       po4a marcheaza traducerile corespunzatoare ca ,,fuzzy" (traduceri
       aproximative) in fi<?>ierul PO pentru a solicita o revizuire manuala de
       catre traducatori. Traducatorii pot furniza, de asemenea,
       a<?>a-numitele ,,addendum", care sunt con<?>inuturi suplimentare care
       precizeaza, de exemplu, cine a realizat traducerea <?>i cum se pot
       raporta erorile.

        documente principale ---+---->-------->------->-------+
         (doc. redactate)       |                             |
                                V       (execu<?>ii po4a)       >-----+--> documente
                                |                             |     |     traduse
        fi<?>iere PO existente  -->--> fisiere PO actualizate >-+     |
                ^                            |                      |
                |                            V                      |
                +----------<---------<-------+                      ^
                (procesul manual de traducere)                      |
                                                                    |
        addendum -->------------------------------------------------+

       Fluxul de lucru al po4a este asincron, potrivit proiectelor de
       cod-sursa deschis. Autorii documenta<?>iei scriu documentele principale
       in ritmul lor propriu. Traducatorii revizuiesc <?>i actualizeaza
       traducerile din fi<?>ierele PO. Responsabilii de intre<?>inere reiau
       po4a la nevoie, pentru a reflecta in fi<?>ierele PO orice modificare a
       documenta<?>iei originale <?>i pentru a produce traduceri actualizate
       ale documenta<?>iei, prin injectarea celei mai recente traduceri in cea
       mai recenta structura a documentului.

       In mod implicit, un anumit document tradus este produs atunci cand cel
       pu<?>in 80% din con<?>inutul sau este tradus. Textul netradus este
       pastrat in limba originala. Documenta<?>ia produsa amesteca astfel
       limbile daca traducerea nu este completa. Pute<?>i modifica pragul de
       80% cu op<?>iunea --keep descrisa mai jos. Re<?>ine<?>i totu<?>i ca
       eliminarea traducerilor de indata ce acestea nu sunt 100% poate fi
       descurajanta pentru traducatorii a caror munca nu va fi aproape
       niciodata prezentata utilizatorilor, in timp ce prezentarea
       ,,traducerilor" care sunt prea incomplete poate fi deranjanta pentru
       utilizatorii finali.

       Stocarea fi<?>ierelor documenta<?>iei traduse in sistemul de control al
       versiunii este probabil o idee proasta, deoarece acestea sunt generate
       automat. Fi<?>ierele pre<?>ioase sunt fi<?>ierele PO, care con<?>in
       munca grea a colegilor traducatori. De asemenea, unele persoane
       considera ca este mai u<?>or sa interac<?>ioneze cu traducatorii
       printr-o platforma activa in Internet, cum ar fi weblate, dar acest
       lucru este, desigur, complet op<?>ional.

   Tutorial de ini<?>iere rapida
       Sa presupunem ca men<?>ine<?>i un program numit foo care are o pagina
       de manual man/foo.1 scrisa in limba engleza (limba punte in majoritatea
       proiectelor de cod sursa deschis, dar po4a poate fi utilizat din sau
       catre orice limba). Cu ceva timp in urma, cineva a furnizat o traducere
       in limba germana numita man/foo.de.1 <?>i a disparut. Aceasta este o
       problema pentru ca tocmai a<?>i primit un raport de eroare care spune
       ca documenta<?>ia dvs. con<?>ine o informa<?>ie grav-in<?>elatoare care
       trebuie corectata in toate limbile, dar nu vorbi<?>i germana, deci
       pute<?>i modifica doar originalul, nu <?>i traducerea. Acum, un alt
       contribuitor dore<?>te sa contribuie cu o traducere in japoneza, o
       limba pe care nici tu nu o stapane<?>ti.

       Este timpul sa va converti<?>i documenta<?>ia in po4a pentru a va
       rezolva co<?>marurile legate de intre<?>inerea documenta<?>iei.
       Dori<?>i sa actualiza<?>i documenta<?>ia atunci cand este necesar,
       dori<?>i sa u<?>ura<?>i munca colegilor dvs. traducatori <?>i dori<?>i
       sa va asigura<?>i ca utilizatorii dvs. nu vad niciodata o
       documenta<?>ie invechita <?>i, prin urmare, in<?>elatoare.

       Conversia include doua etape: configurarea infrastructurii po4a <?>i
       convertirea traducerii germane anterioare pentru a salva munca
       anterioara. Aceasta ultima parte este realizata utilizand
       po4a-gettextize, dupa cum urmeaza. Dupa cum se detaliaza in
       documenta<?>ia po4a-gettextize(1), acest proces rareori este complet
       automat, dar odata realizat, fi<?>ierul de.po care con<?>ine traducerea
       germana poate fi integrat in fluxul de lucru po4a.

         po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po

       Sa configuram acum po4a. Cu aspectul corespunzator al fi<?>ierului,
       fi<?>ierul dvs. de configurare ar putea fi la fel de simplu ca acesta:

        [po_directory] man/po4a/

        [type: man] man/foo.1 $lang:man/translated/foo.$lang.1

       Aceasta specifica faptul ca toate fi<?>ierele PO (care con<?>in munca
       traducatorilor) se afla in directorul man/po4a/ <?>i ca ave<?>i un
       singur fi<?>ier principal, man/foo.1. Daca a<?>i avea mai multe
       fi<?>iere principale, a<?>i avea mai multe linii similare celei de-a
       doua. Fiecare astfel de linie specifica, de asemenea, unde sa se scrie
       fi<?>ierele de traducere corespunzatoare. Aici, traducerea in limba
       germana a fi<?>ierului man/foo.1 este in man/translated/foo.de.1.

       Ultimul lucru de care avem nevoie pentru a finaliza configurarea po4a
       este un fi<?>ier POT care con<?>ine materialul <?>ablon care ar trebui
       utilizat pentru a incepe o noua traducere. Crea<?>i pur <?>i simplu un
       fi<?>ier gol cu extensia .pot in directorul po_directory specificat (de
       exemplu, man/po4a/foo.pot), iar po4a il va umple cu con<?>inutul
       a<?>teptat.

       Iata o recapitulare a fi<?>ierelor din aceasta configura<?>ie:

         <?><?><?> man/
         |   <?><?><?> foo.1        <- Pagina de manual originala, in limba engleza
         |   <?><?><?> po4a/
         |   |   <?><?><?> de.po    <- Traducerea PO in limba germana, de la gettextizare
         |   |   <?><?><?> foo.pot  <- <?>ablonul POT al viitoarelor traduceri (gol la inceput)
         |   <?><?><?> translated/  <- Directorul in care vor fi create traducerile
         <?><?><?> po4a.cfg         <- Fi<?>ierul de configurare

       Odata configurat, execu<?>ia po4a va analiza documenta<?>ia, va
       actualiza fi<?>ierul <?>ablon POT, il va utiliza pentru a actualiza
       fi<?>ierele de traducere PO <?>i le va utiliza pentru a actualiza
       fi<?>ierele de traducere a documenta<?>iei. Totul intr-o singura
       comanda:

               po4a --verbose po4a.cfg

       Asta este tot. po4a este acum complet configurat. Dupa ce a<?>i
       corectat eroarea din man/foo.1, paragraful incorect din traducerea in
       germana va fi inlocuit cu textul corectat in engleza. Amestecarea
       limbilor nu este optima, dar este singura modalitate de a elimina
       erorile din traduceri pe care nici macar nu le in<?>elege<?>i <?>i de a
       va asigura ca con<?>inutul prezentat utilizatorilor nu este niciodata
       in<?>elator. Actualizarea traducerii in limba germana este, de
       asemenea, mult mai u<?>oara in fi<?>ierul PO corespunzator, astfel
       incat amestecul de limbi poate sa nu dureze mult. In cele din urma,
       atunci cand un traducator japonez dore<?>te sa contribuie cu o noua
       traducere, ar trebui sa redenumeasca fi<?>ierul foo.pot in ja.po <?>i
       sa completeze traducerea. Odata ce ave<?>i acest fi<?>ier,
       introduce<?>i-l in man/po4a/po/. O pagina tradusa va aparea ca
       man/translated/foo.ja.1 (cu condi<?>ia ca o cantitate suficienta de
       con<?>inut sa fie tradusa) atunci cand executa<?>i din nou po4a.

OP<?>IUNI
       -k, --keep
           Pragul minim pentru procentul de traducere pentru a pastra (adica a
           scrie) fi<?>ierul rezultat (implicit: 80). Adica, in mod implicit,
           fi<?>ierele trebuie sa fie traduse la cel pu<?>in 80% pentru a fi
           scrise pe disc.

       -w, --width
           Coloana la care ar trebui sa incadram fi<?>ierul rezultat daca
           formatul accepta acest lucru (implicit: 76). Daca valoarea
           furnizata este 0 sau negativa, atunci fi<?>ierul rezultat nu va fi
           incadrat deloc. Acest lucru este util in cazul anumitor formate
           care s-ar putea rupe atunci cand sunt re-incadrate.

       -h, --help
           Afi<?>eaza un scurt mesaj de ajutor.

       -M, --master-charset
           Setul de caractere al fi<?>ierelor care con<?>in documentele de
           tradus. Re<?>ine<?>i ca toate documentele principale trebuie sa
           utilizeze acela<?>i set de caractere.

       -L, --localized-charset
           Setul de caractere al fi<?>ierelor care con<?>in documentele de
           tradus. Re<?>ine<?>i ca toate documentele traduse vor utiliza
           acela<?>i set de caractere.

       -A, --addendum-charset
           Setul de caractere al addendei. Re<?>ine<?>i ca toate addendele
           trebuie sa fie in acela<?>i set de caractere.

       -V, --version
           Afi<?>eaza versiunea scriptului <?>i iese.

       -v, --verbose
           Cre<?>te nivelul de detaliere al programului.

       -q, --quiet
           Reduce nivelul de detaliere al programului.

       -d, --debug
           Afi<?>eaza unele informa<?>ii de depanare.

       -o, --option
           Op<?>iuni suplimentare pe care sa le transmite<?>i modulului de
           format. Consulta<?>i documenta<?>ia fiecarui modul pentru mai multe
           informa<?>ii despre op<?>iunile valide <?>i semnifica<?>iile
           acestora. De exemplu, a<?>i putea transmite ,,-o tablecells"
           analizatorului AsciiDoc, in timp ce analizatorul de text ar accepta
           ,,-o tabs=split".

       -f, --force
           Genereaza intotdeauna fi<?>ierele POT <?>i PO, chiar daca po4a
           considera ca nu este necesar.

           Comportamentul implicit (atunci cand op<?>iunea --force nu este
           specificata) este urmatorul:

               In cazul in care fi<?>ierul POT exista deja, acesta este
               regenerat daca un document principal sau fi<?>ierul de
               configurare este mai recent (cu excep<?>ia cazului in care se
               furnizeaza --no-update). De asemenea, fi<?>ierul POT este scris
               intr-un document temporar, iar po4a verifica daca modificarile
               sunt intr-adevar necesare.

               De asemenea, o traducere este regenerata numai daca documentul
               sau principal, fi<?>ierul PO, unul dintre addenda sau
               fi<?>ierul de configurare este mai recent. Pentru a evita
               incercarea de regenerare a traducerilor care nu trec testul
               pragului (a se vedea --keep), poate fi creat un fi<?>ier cu
               extensia .po4a-stamp (a se vedea --stamp).

           Daca un document principal include fi<?>iere, trebuie sa
           utiliza<?>i marcajul --force deoarece timpul de modificare al
           acestor fi<?>iere incluse nu este luat in considerare.

           Fi<?>ierele PO sunt intotdeauna re-generate pe baza POT cu msgmerge
           -U.

       --stamp
           Ii indica lui po4a sa creeze fi<?>iere <?>tampila (marca-de-timp)
           atunci cand o traducere nu este generata deoarece nu atinge pragul.
           Aceste fi<?>iere <?>tampila sunt denumite in func<?>ie de
           documentul tradus a<?>teptat, cu extensia .po4a-stamp.

           Nota: Aceasta activeaza doar crearea fi<?>ierelor .po4a-stamp.
           Fi<?>ierele <?>tampila sunt intotdeauna utilizate daca exista <?>i
           sunt eliminate cu --rm-translations sau atunci cand fi<?>ierul este
           tradus definitiv.

       --no-translations
           Nu genereaza documentele traduse, ci doar actualizeaza fi<?>ierele
           POT <?>i PO.

       --no-update
           Nu modifica fi<?>ierele POT <?>i PO, doar traducerea poate fi
           actualizata.

       --keep-translations
           Pastreaza fi<?>ierele de traducere existente chiar daca traducerea
           nu atinge pragul specificat de --keep. Aceasta op<?>iune nu creeaza
           noi fi<?>iere de traducere cu con<?>inut redus, dar va salva
           traducerile existente care se degradeaza din cauza modificarilor
           aduse fi<?>ierelor principale.

           AVERTISMENT: Aceasta op<?>iune schimba comportamentul po4a intr-un
           mod destul de drastic: fi<?>ierele dvs. traduse nu vor fi
           actualizate deloc pana cand traducerea nu se imbunata<?>e<?>te.
           Utiliza<?>i aceasta op<?>iune numai daca prefera<?>i sa trimite<?>i
           o documenta<?>ie tradusa invechita in loc sa trimite<?>i o
           documenta<?>ie netradusa corecta.

       --rm-translations
           Elimina fi<?>ierele traduse (implica --no-translations).

       --no-backups
           Aceasta op<?>iune nu are niciun efect de la versiunea 0.41 <?>i
           poate fi eliminata in versiunile ulterioare.

       --rm-backups
           Aceasta op<?>iune nu are niciun efect de la versiunea 0.41 <?>i
           poate fi eliminata in versiunile ulterioare.

       --translate-only fi<?>ier-traducere
           Traduce numai fi<?>ierul specificat. Aceasta poate fi utila pentru
           a accelera procesarea daca un fi<?>ier de configurare con<?>ine
           multe fi<?>iere. Re<?>ine<?>i ca aceasta op<?>iune nu actualizeaza
           fi<?>ierele PO <?>i POT. Aceasta op<?>iune poate fi utilizata de
           mai multe ori.

       --variable variabila=valoare
           Define<?>te o variabila care va fi extinsa in fi<?>ierul de
           configurare po4a. Fiecare apari<?>ie a lui $(var) va fi inlocuita
           cu valoare. Aceasta op<?>iune poate fi utilizata de mai multe ori.

       --target-lang LIMBA
           Actualizeaza fi<?>ierele PO <?>i genereaza documente traduse numai
           pentru limba specificata. Aceasta op<?>iune poate fi utilizata de
           mai multe ori.

       --srcdir DIR_SURSA
           Define<?>te directorul de baza pentru toate documentele de intrare
           specificate in fi<?>ierul de configurare po4a.

           Daca sunt specificate atat DIR_DESTINA<?>IE, cat <?>i DIR_SURSA,
           fi<?>ierele de intrare sunt cautate in urmatoarele directoare, in
           ordine: DIR_DESTINA<?>IE, directorul curent <?>i DIR_SURSA.
           Fi<?>ierele de ie<?>ire sunt scrise in DIR_DESTINA<?>IE, daca este
           specificat, sau in directorul curent.

       --destdir DIR_DESTINA<?>IE
           Define<?>te directorul de baza pentru toate documentele de ie<?>ire
           specificate in fi<?>ierul de configurare po4a (a se vedea
           op<?>iunea --srcdir de mai sus).

   Op<?>iuni ce modifica antetul POT
       --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.

       --master-language
           Limba fi<?>ierelor sursa care con<?>in documentele de tradus.
           Re<?>ine<?>i ca toate documentele principale trebuie sa utilizeze
           aceea<?>i limba.

       --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".

   Op<?>iuni pentru modificarea fi<?>ierelor PO
       --msgmerge-opt op<?>iuni
           Op<?>iuni suplimentare pentru msgmerge(1).

           Nota: $lang va fi extins la limba curenta.

       --no-previous
           Aceasta op<?>iune elimina --previous din op<?>iunile transmise
           catre msgmerge. Acest lucru este necesar pentru a oferi suport
           versiunilor de gettext anterioare versiunii 0.16.

       --previous
           Aceasta op<?>iune adauga --previous la op<?>iunile transmise catre
           msgmerge. Aceasta necesita gettext 0.16 sau o versiune ulterioara
           <?>i este activata implicit.

FI<?>IERUL DE CONFIGURARE
       po4a a<?>teapta ca argument un fi<?>ier de configurare. Acest fi<?>ier
       trebuie sa con<?>ina urmatoarele elemente:

       o   Ruta catre fi<?>ierele PO <?>i lista de limbi existente in proiect;

       o   Op<?>ional, unele op<?>iuni globale <?>i a<?>a-numitele alias de
           configurare care sunt utilizate ca <?>abloane pentru a configura
           fi<?>iere principale individual;

       o   Lista fiecarui fi<?>ier principal de tradus, impreuna cu parametrii
           specifici.

       Toate liniile con<?>in o comanda intre paranteze drepte, urmata de
       parametrii acesteia. Comentariile incep cu caracterele ,,#" <?>i
       continua pana la sfar<?>itul liniei. Pute<?>i eluda sfar<?>itul liniei
       pentru a intinde o comanda pe mai multe linii.

       Unele exemple complete sunt prezentate pe aceasta pagina, in timp ce
       alte exemple pot fi gasite in directorul "t/cfg" al distribu<?>iei
       sursa.

   Gasirea fi<?>ierelor PO <?>i POT
       Cea mai simpla solu<?>ie este de a indica in mod explicit ruta catre
       fi<?>ierele POT <?>i PO, dupa cum urmeaza:

        [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po

       Aceasta specifica mai intai ruta catre fi<?>ierul POT <?>i apoi rutele
       catre fi<?>ierele PO in limbile germana <?>i franceza.

       Acelea<?>i informa<?>ii pot fi scrise dupa cum urmeaza pentru a reduce
       riscul de erori de copiere/lipire:

        [po4a_langs] fr de
        [po4a_paths] man/po/project.pot $lang:man/po/$lang.po

       Componenta $lang este extinsa automat folosind lista de limbi
       furnizata, reducand riscul de erori de copiere/lipire atunci cand este
       adaugata o limba noua.

       Pute<?>i compacta in continuare acelea<?>i informa<?>ii furnizand doar
       ruta catre directorul care con<?>ine proiectul dvs. de traducere, dupa
       cum urmeaza.

        [po_directory] man/po/

       Directorul furnizat trebuie sa con<?>ina un set de fi<?>iere PO,
       fiecare denumit XX.po, "XX" fiind codul ISO 639-1 al limbii utilizate
       in acest fi<?>ier. Directorul trebuie sa con<?>ina, de asemenea, un
       singur fi<?>ier POT, cu extensia de fi<?>ier ".pot". Pentru prima
       rulare, acest fi<?>ier poate fi gol, dar trebuie sa existe (po4a nu
       poate ghici numele de utilizat inainte de extensie).

       Re<?>ine<?>i ca trebuie sa alege<?>i doar una dintre variantele
       "po_directory" <?>i "po4a_paths". Prima ("po_directory") este mai
       compacta, reduce <?>i mai mult riscul erorilor de copiere/lipire, dar
       va obliga sa utiliza<?>i structura de proiect <?>i numele de fi<?>iere
       a<?>teptate. A doua ("po4a_paths"), este mai explicita, probabil mai
       u<?>or de citit <?>i este recomandata atunci cand configura<?>i primul
       proiect cu po4a.

       Fi<?>iere PO centralizate sau divizate?

       In mod implicit, po4a produce un singur fi<?>ier PO pentru fiecare
       limba <?>inta, con<?>inand intregul con<?>inut al proiectului dvs. de
       traducere. Pe masura ce proiectul dumneavoastra cre<?>te, dimensiunea
       acestor fi<?>iere poate deveni problematica. Atunci cand utiliza<?>i
       weblate, este posibil sa specifica<?>i priorita<?>i pentru fiecare
       segment de traducere (de exemplu, msgid), astfel incat cele importante
       sa fie traduse primele. Totu<?>i, unele echipe de traducatori prefera
       sa imparta con<?>inutul in mai multe fi<?>iere.

       Pentru a avea un fi<?>ier PO pentru fiecare fi<?>ier principal, trebuie
       doar sa utiliza<?>i <?>irul $master in numele fi<?>ierelor PO de pe
       linia "[po4a_paths]", dupa cum urmeaza.

        [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

       Cu aceasta linie, po4a va produce fi<?>iere POT <?>i PO separate pentru
       fiecare document de tradus. De exemplu, daca ave<?>i 3 documente <?>i 5
       limbi, aceasta va avea ca rezultat 3 fi<?>iere POT <?>i 15 fi<?>iere
       PO. Aceste fi<?>iere sunt denumite dupa cum se specifica in <?>ablonul
       "po4a_paths", cu $master inlocuit cu numele de baza al fiecarui
       document de tradus. In caz de conflict de nume, pute<?>i specifica
       fi<?>ierul POT de utilizat dupa cum urmeaza, cu parametrul "pot=".

       Aceasta caracteristica poate fi utilizata <?>i pentru a grupa mai multe
       fi<?>iere traduse in acela<?>i fi<?>ier POT. Urmatorul exemplu produce
       doar 2 fi<?>iere POT: l10n/po/foo.pot (con<?>inand materialul din
       foo/gui.xml) <?>i l10n/po/bar.pot (con<?>inand materialul din
       bar/gui.xml <?>i bar/cli.xml).

        [po4a_langs] de fr ja
        [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
        [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo
        [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar
        [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar

       In modul divizare, po4a construie<?>te un compendiu temporar in timpul
       actualizarii PO, pentru a partaja traducerile intre toate fi<?>ierele
       PO. In cazul in care doua fi<?>iere PO au traduceri diferite pentru
       acela<?>i <?>ir de caractere, po4a va marca acest <?>ir ca fiind fuzzy
       <?>i va prezenta ambele traduceri in toate fi<?>ierele PO care con<?>in
       acest <?>ir de caractere. In cazul in care traductorul a eliminat
       fuzzy-ul, traducerea este utilizata automat in toate fi<?>ierele PO.

   Specificarea documentelor de tradus
       De asemenea, trebuie sa lista<?>i documentele care trebuie traduse.
       Pentru fiecare fi<?>ier principal, trebuie sa specifica<?>i
       analizatorul de format care urmeaza sa fie utilizat, loca<?>ia
       documentului tradus care urmeaza sa fie produs <?>i, op<?>ional, o
       anumita configurare. Numele fi<?>ierelor trebuie sa fie puse intre
       ghilimele sau eludate daca con<?>in spa<?>ii. Iata un exemplu:

        [type: sgml] "doc/my stuff.sgml"  "fr:doc/fr/mon truc.sgml"  de:doc/de/mein\ kram.sgml
        [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
        [type: docbook] doc/script.xml fr:doc/fr/script.xml \
                    de:doc/de/script.xml

       Dar, din nou, aceste linii complexe sunt dificil de citit <?>i de
       modificat, de exemplu atunci cand se adauga un nou limbaj. Este mult
       mai simplu sa reorganiza<?>i lucrurile folosind <?>ablonul $lang dupa
       cum urmeaza:

        [type: sgml]    doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml
        [type: man]     script.1          $lang:po/$lang/script.1
        [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml

   Specificarea op<?>iunilor
       Exista doua tipuri de op<?>iuni: op<?>iuni po4a sunt valorile implicite
       ale op<?>iunilor din linia de comanda po4a, in timp ce op<?>iuni format
       sunt utilizate pentru a modifica comportamentul analizatorilor de
       format. Ca op<?>iuni po4a, a<?>i putea, de exemplu, sa specifica<?>i in
       fi<?>ierul dvs. de configurare ca valoarea implicita a parametrului de
       linie de comanda --keep este 50% in loc de 80%. Op<?>iunile de format
       sunt documentate pe pagina specifica a fiecarui modul de analizare, de
       exemplu Locale::Po4a::Xml(3pm). A<?>i putea, de exemplu, sa trece<?>i
       nostrip analizorului XML pentru a nu elimina spa<?>iile din jurul
       <?>irurilor extrase.

       Pute<?>i trece aceste op<?>iuni pentru un anumit fi<?>ier principal sau
       chiar pentru o anumita traducere a fi<?>ierului respectiv, utilizand
       "opt:" <?>i "opt_XX:" pentru limba "XX". In exemplul urmator,
       op<?>iunea nostrip este transmisa analizatorului XML (pentru toate
       limbile), in timp ce pragul va fi redus la 0% pentru traducerea in
       franceza (care este astfel pastrata intotdeauna).

        [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"

       In orice caz, aceste buca<?>i de configurare trebuie sa fie situate la
       sfar<?>itul liniei. Declara<?>ia fi<?>ierelor trebuie sa fie prima,
       apoi addendumul, daca exista (a se vedea mai jos), <?>i apoi doar
       op<?>iunile. Gruparea buca<?>ilor de configurare nu este foarte
       importanta, deoarece elementele sunt concatenate intern ca <?>iruri de
       caractere. Exemplele urmatoare sunt toate echivalente:

         [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
         [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
         [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0

       Re<?>ine<?>i ca op<?>iunile specifice fiecarei limbi nu sunt utilizate
       la crearea fi<?>ierului POT. De exemplu, este imposibil sa
       transmite<?>i nostrip analizatorului doar atunci cand crea<?>i
       traducerea in franceza, deoarece acela<?>i fi<?>ier POT este utilizat
       pentru actualizarea fiecarei limbi. Prin urmare, singurele op<?>iuni
       care pot fi specifice unei limbi sunt cele care sunt utilizate la
       realizarea traducerii, cum ar fi op<?>iunea "--keep".

       Alias de configurare

       Pentru a transmite acelea<?>i op<?>iuni mai multor fi<?>iere, cel mai
       bine este sa defini<?>i un alias de tip dupa cum urmeaza. In exemplul
       urmator, "--keep 0" este transmis la fiecare traducere italiana
       folosind acest tip "test", adica o extensie a tipului "man".

         [po4a_alias:test] man opt_it:"--keep 0"
         [type: test] man/page.1 $lang:man/$lang/page.1

       De asemenea, pute<?>i extinde un tip existent reutilizand acela<?>i
       nume pentru alias, dupa cum urmeaza. Aceasta nu este interpretata ca o
       defini<?>ie recursiva eronata.

         [po4a_alias:man] man opt_it:"--keep 0"
         [type: man] man/page.1 $lang:man/$lang/page.1

       Op<?>iuni implicite globale

       De asemenea, pute<?>i utiliza liniile "[options]" pentru a defini
       op<?>iuni care trebuie utilizate pentru toate fi<?>ierele, indiferent
       de tipul acestora.

         [options] --keep 20 --option nostrip

       Ca <?>i in cazul op<?>iunilor din linia de comanda, pute<?>i abrevia
       parametrii trecu<?>i in fi<?>ierul de configurare:

         [options] -k 20 -o nostrip

       Prioritatea op<?>iunilor

       Op<?>iunile fiecarei surse sunt concatenate, asigurandu-se ca valorile
       implicite pot fi u<?>or anulate prin op<?>iuni mai specifice. Ordinea
       este urmatoarea:

       o   Liniile "[options]" furnizeaza valori implicite care pot fi anulate
           de orice alta sursa.

       o   Se utilizeaza apoi alias de tip. Op<?>iuniile specifice limbii
           prevaleaza asupra celor aplicabile tuturor limbilor.

       o   Op<?>iunile specifice unui anumit fi<?>ier principal prevaleaza
           atat asupra celor implicite, cat <?>i asupra celor care provin din
           pseudonimul de tip. De asemenea, in acest caz, op<?>iunile
           specifice limbii prevaleaza asupra celor globale.

       o   In cele din urma, parametrii furniza<?>i in linia de comanda po4a
           prevaleaza asupra oricaror op<?>iuni din fi<?>ierul de configurare.

       Exemplu

       Iata un exemplu care arata cum sa cita<?>i spa<?>iile <?>i ghilimelele:

        [po_directory] man/po/

        [options] --master-charset UTF-8

        [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
        [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
                   opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose

   Addendum: Adaugarea de con<?>inut suplimentar in traducere
       Daca dori<?>i sa adauga<?>i o sec<?>iune suplimentara la traducere, de
       exemplu pentru a acorda mul<?>umiri traducatorului, atunci trebuie sa
       defini<?>i un addendum la linia care define<?>te fi<?>ierul principal.
       Va rugam sa consulta<?>i pagina po4a(7) pentru mai multe detalii
       privind sintaxa fi<?>ierelor addendum.

        [type: pod] script fr:doc/fr/script.1 \
                    add_fr:doc/l10n/script.fr.add

       De asemenea, pute<?>i utiliza <?>abloane de limba dupa cum urmeaza:

        [type: pod] script $lang:doc/$lang/script.1 \
                    add_$lang:doc/l10n/script.$lang.add

       Daca un addendum e<?>ueaza la aplicare, traducerea este respinsa.

       Modificatori pentru declara<?>ia de addendum

       Modificatorii de addendum pot simplifica fi<?>ierul de configurare in
       cazul in care nu toate limbile furnizeaza un addendum sau atunci cand
       lista de addendumuri se modifica de la o limba la alta. Modificatorul
       este un singur caracter situat inaintea numelui fi<?>ierului.

       ? Include ruta_la_addendum daca acest fi<?>ier exista, altfel nu face
         nimic.

       @ ruta_la_addendum nu este un addendum obi<?>nuit, ci un fi<?>ier care
         con<?>ine o lista de addenda, rand pe rand. Fiecare addendum poate fi
         precedat de modificatori.

       ! ruta_la_addendum (fi<?>ierul catre care arata) este inlaturat, nu
         este incarcat <?>i nu va fi incarcat de nicio alta specifica<?>ie de
         addendum.

       Urmatoarele includ un addendum in orice limba, dar numai daca acesta
       exista. Nu este raportata nicio eroare daca addendumul nu exista.

        [type: pod] script $lang:doc/$lang/script.1  add_$lang:?doc/l10n/script.$lang.add

       Urmatoarele includ o lista de addendumuri pentru fiecare limba:

        [type: pod] script $lang:doc/$lang/script.1  add_$lang:@doc/l10n/script.$lang.add

   Filtrarea <?>irurilor traduse
       Uneori, dori<?>i sa ascunde<?>i anumite <?>iruri de caractere de
       procesul de traducere. In acest scop, pute<?>i oferi un parametru
       "pot_in" fi<?>ierului principal pentru a specifica numele fi<?>ierului
       care urmeaza sa fie utilizat in locul fi<?>ierului principal real la
       construirea fi<?>ierului POT. Iata un exemplu:

         [type:docbook] book.xml          \
                 pot_in:book-filtered.xml \
                 $lang:book.$lang.xml

       Cu aceasta configurare, <?>irurile de caractere de tradus vor fi
       extrase din book-filtered.xml (care trebuie produs inainte de a apela
       po4a), in timp ce fi<?>ierele traduse vor fi construite din book.xml.
       Ca urmare, orice <?>ir care face parte din book.xml, dar nu din
       book-filtered.xml nu va fi inclus in fi<?>ierele PO, impiedicand
       traducatorii sa furnizeze o traducere pentru acestea. Astfel, aceste
       <?>iruri de caractere vor ramane nemodificate la producerea
       documentelor traduse. Acest lucru scade in mod natural nivelul de
       traducere, astfel incat este posibil sa ave<?>i nevoie de op<?>iunea
       "--keep" pentru a va asigura ca documentul este produs oricum.

CONSULTA<?>I <?>I
       po4a-gettextize(1), po4a(7).

AUTORI
        Denis Barbier <barbier@linuxfr.org>
        Nicolas Francois <nicolas.francois@centraliens.net>
        Martin Quinson (mquinson#debian.org)

DREPTURI DE AUTOR <?>i LICEN<?>A
       Drepturi de autor 2002-2023 pentru SPI, inc.

       Acest program este software liber; il pute<?>i redistribui <?>i/sau
       modifica in conformitate cu termenii GPL v2.0 sau o versiune ulterioara
       (consulta<?>i fi<?>ierul COPYING).

perl v5.42.0                      2025-11-22                        PO4A.1P(1)