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


NUME
       po4a-gettextize - converte<?>te un fi<?>ier original (<?>i traducerea
       sa) intr-un fi<?>ier PO

SINOPSIS
       po4a-gettextize -f fmt -m principal.doc -l XX.doc -p XX.po

       (XX.po este ie<?>irea, toate celelalte sunt intrarile)

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.

       Scriptul po4a-gettextize va ajuta sa converti<?>i traducerile existente
       anterior intr-un flux de lucru bazat pe po4a. Acest lucru trebuie facut
       o singura data pentru a salva o traducere existenta in timpul
       conversiei in po4a, nu in mod regulat dupa conversia proiectului dvs.
       Acest proces anevoios este explicat in detaliu in sec<?>iunea
       ,,Conversia unei traduceri manuale in po4a" de mai jos.

       Trebuie sa furniza<?>i atat un fi<?>ier principal (de exemplu, sursa in
       limba engleza), cat <?>i un fi<?>ier tradus existent (de exemplu, o
       incercare anterioara de traducere fara po4a). Daca furniza<?>i mai
       multe fi<?>iere principale sau de traducere, acestea vor fi utilizate
       in succesiune, dar poate fi mai u<?>or sa ,,gettextiza<?>i" fiecare
       pagina sau capitol separat <?>i apoi sa utiliza<?>i msgmerge pentru a
       fuziona toate fi<?>ierele PO produse. Dupa cum dori<?>i.

       Daca documentul principal are caractere non-ASCII, noul fi<?>ier PO
       generat va fi in UTF-8. Daca documentul principal este complet in
       ASCII, PO generat va utiliza codificarea documentului de intrare
       tradus.

OP<?>IUNI
       -f, --format
           Formatul documenta<?>iei pe care dori<?>i sa o gestiona<?>i.
           Utiliza<?>i op<?>iunea --help-format pentru a vedea lista de
           formate disponibile.

       -m, --master
           Fi<?>ier care con<?>ine documentul principal de tradus. Pute<?>i
           utiliza aceasta op<?>iune de mai multe ori daca dori<?>i sa
           ,,gettextiza<?>i" mai multe documente.

       -M, --master-charset
           Setul de caractere al fi<?>ierului care con<?>ine documentul de
           tradus.

       -l, --localized
           Fi<?>ier care con<?>ine documentul localizat (tradus). Daca a<?>i
           furnizat mai multe fi<?>iere principale, este posibil sa dori<?>i
           sa furniza<?>i mai multe fi<?>iere localizate prin utilizarea
           acestei op<?>iuni de mai multe ori.

       -L, --localized-charset
           Setul de caractere al fi<?>ierului care con<?>ine documentul
           localizat.

       -p, --po
           Fi<?>ier in care ar trebui scris catalogul de mesaje. Daca nu este
           dat, catalogul de mesaje va fi scris la ie<?>irea standard.

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

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

       --help-format
           Enumera formatele de documenta<?>ie in<?>elese de po4a.

       -k --keep-temps
           Pastreaza fi<?>ierele principale temporare <?>i fi<?>ierele POT
           localizate construite inainte de fuzionare. Acest lucru poate fi
           util pentru a in<?>elege de ce aceste fi<?>iere se desincronizeaza,
           ducand la probleme de gettextizare.

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

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

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

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

   Conversia unei traduceri manuale in po4a
       po4a-gettextize sincronizeaza fi<?>ierele principale <?>i localizate
       pentru a extrage con<?>inutul acestora intr-un fi<?>ier PO.
       Con<?>inutul fi<?>ierului principal da msgid, in timp ce con<?>inutul
       fi<?>ierului localizat da msgstr. Acest proces este oarecum fragil: al
       N-lea <?>ir din fi<?>ierul tradus ar trebui sa fie traducerea celui
       de-al N-lea <?>ir din original.

       Gettextizarea func<?>ioneaza cel mai bine daca reu<?>i<?>i sa
       recupera<?>i versiunea exacta a documentului original care a fost
       utilizat pentru traducere. Chiar <?>i a<?>a, este posibil sa fie nevoie
       sa va descurca<?>i atat cu fi<?>ierele principale, cat <?>i cu cele
       localizate pentru a le alinia structura daca aceasta a fost modificata
       de traducatorul original, astfel incat este recomandat sa lucra<?>i pe
       copii ale fi<?>ierelor.

       La nivel intern, fiecare analizator po4a raporteaza tipul sintactic al
       fiecarui <?>ir de caractere extras. Acesta este modul in care sunt
       detectate desincronizarile in timpul gettextizarii. In exemplul
       prezentat mai jos, este foarte pu<?>in probabil ca al 4-lea <?>ir din
       traducere (de tip ,,capitol") sa fie traducerea celui de-al 4-lea <?>ir
       din original (de tip ,,paragraf"). Este mai probabil ca un nou paragraf
       sa fi fost adaugat la original sau ca doua paragrafe originale sa fi
       fost fuzionate in traducere.

           Original         Traducerea

         capitol            capitol
           paragraf           paragraf
           paragraf           paragraf
           paragraf         capitol
         capitol              paragraf
           paragraf           paragraf

       po4a-gettextize va diagnostica foarte detaliat orice desincronizare a
       structurii. Atunci cand se intampla acest lucru, ar trebui sa edita<?>i
       manual fi<?>ierele pentru a adauga paragrafe false sau pentru a elimina
       unele con<?>inuturi ici <?>i colo pana cand structura ambelor fi<?>iere
       se potrive<?>te cu adevarat. Mai jos sunt prezentate cateva trucuri
       pentru a salva cea mai mare parte din traducerea existenta in acest
       timp.

       Daca sunte<?>i suficient de norocos sa ave<?>i o potrivire perfecta in
       structurile de fi<?>iere din cutie, construirea unui fi<?>ier PO corect
       este o chestiune de secunde. In caz contrar, ve<?>i in<?>elege in
       curand de ce acest proces are un nume atat de urat :) Chiar <?>i a<?>a,
       ,,gettextizarea" ramane adesea mai rapida decat traducerea din nou a
       tot. Am ,,gettextizat" traducerea in franceza a intregii documenta<?>ii
       Perl intr-o singura zi, in ciuda multor probleme de sincronizare. Avand
       in vedere cantitatea de text (2 Mo de text original), reinceperea
       traducerii fara a salva mai intai vechile traduceri ar fi necesitat mai
       multe luni de munca. In plus, aceasta munca bruta este pre<?>ul de
       platit pentru a ob<?>ine confortul po4a. Odata convertita,
       sincronizarea intre documentele principale <?>i traduceri va fi
       intotdeauna complet automata.

       Dupa o gettextizare reu<?>ita, documentele produse ar trebui sa fie
       verificate manual pentru disparita<?>i nedetectate <?>i erori
       silen<?>ioase, dupa cum se explica mai jos.

       Sfaturi <?>i trucuri pentru procesul de ,,gettextizare"

       Gettextizarea se opre<?>te imediat ce este detectata o desincronizare.
       Cand se intampla acest lucru, trebuie sa edita<?>i fi<?>ierele atat cat
       este necesar pentru a realinia structurile fi<?>ierelor.
       po4a-gettextize este destul de ,,guraliv" atunci cand lucrurile merg
       prost. Acesta raporteaza <?>irurile care nu se potrivesc, pozi<?>iile
       lor in text <?>i tipul fiecaruia dintre ele. In plus, fi<?>ierul PO
       generat pana acum este transferat ca gettextization.failed.po pentru o
       inspec<?>ie ulterioara.

       Iata cateva trucuri pentru a va ajuta in acest proces anevoios <?>i
       pentru a va asigura ca salva<?>i cea mai mare parte din traducerea
       anterioara:

       o   Elimina<?>i tot con<?>inutul suplimentar al traducerilor, cum ar fi
           sec<?>iunea care ofera credite (recunoa<?>terea meritelor,
           mul<?>umiri, <?>.a.)  traducatorilor. Acestea ar trebui adaugate
           separat la po4a ca addenda (a se vedea po4a(7)).

       o   Cand edita<?>i fi<?>ierele pentru a le alinia structurile,
           prefera<?>i editarea traducerii, daca este posibil. Intr-adevar,
           daca modificarile aduse originalului sunt prea intruzive,
           versiunile veche <?>i noua nu vor fi comparate in timpul primei
           execu<?>ii po4a dupa ,,gettextizarea" (a se vedea mai jos). Orice
           traducere nepotrivita va fi oricum abandonata. Acestea fiind spuse,
           dori<?>i in continuare sa edita<?>i documentul original in cazul in
           care este prea greu sa ob<?>ine<?>i ,,gettextizarea" pentru a
           continua altfel, chiar daca aceasta inseamna ca un paragraf din
           traducere este aruncat. Important este sa ob<?>ine<?>i un prim
           fi<?>ier PO pentru a incepe.

       o   Nu ezita<?>i sa elimina<?>i orice con<?>inut original care nu ar
           exista in versiunea tradusa. Acest con<?>inut va fi reintrodus
           automat ulterior, la sincronizarea fi<?>ierului PO cu documentul.

       o   Probabil ca ar trebui sa informa<?>i autorul original cu privire la
           orice modificare structurala in traducere care pare justificata.
           Problemele din documentul original ar trebui raportate autorului.
           Rezolvarea lor in traducerea dvs. le rezolva doar pentru o parte a
           comunita<?>ii. In plus, este imposibil sa face<?>i acest lucru
           atunci cand utiliza<?>i po4a ;) Dar probabil dori<?>i sa
           a<?>tepta<?>i pana la sfar<?>itul conversiei la po4a inainte de a
           modifica fi<?>ierele originale.

       o   Uneori, con<?>inutul paragrafelor se potrive<?>te, dar nu <?>i
           tipurile lor. Rezolvarea depinde mai degraba de format. In POD <?>i
           man, aceasta provine adesea din faptul ca unul dintre ele con<?>ine
           un rand care incepe cu un spa<?>iu alb, in timp ce celalalt nu. In
           aceste formate, un astfel de paragraf nu poate fi incadrat <?>i
           devine astfel un tip diferit. Indeparta<?>i spa<?>iul <?>i
           sunte<?>i in regula. De asemenea, poate fi vorba de o gre<?>eala de
           dactilografiere a numelui etichetei in XML.

           De asemenea, doua paragrafe pot fi imbinate in POD atunci cand
           linia de separare con<?>ine cateva spa<?>ii sau cand nu exista o
           linie goala intre linia =item <?>i con<?>inutul articolului.

       o   Uneori, mesajul de desincronizare pare ciudat deoarece traducerea
           este ata<?>ata la paragraful original gre<?>it. Acesta este semnul
           unei probleme nedetectate mai devreme in proces. Cauta<?>i punctul
           real de desincronizare prin inspectarea fi<?>ierului
           gettextization.failed.po care a fost produs <?>i rezolva<?>i
           problema acolo unde este cu adevarat.

       o   Alte probleme pot proveni din <?>iruri de caractere duplicate, fie
           in original, fie in traducere. <?>irurile duplicate sunt fuzionate
           in fi<?>ierele PO, cu doua referin<?>e. Acest lucru constituie o
           dificultate pentru algoritmul de gettextizare, care este o simpla
           imperechere unu la unu intre msgid-urile din fi<?>ierele principale
           <?>i cele localizate. Cu toate acestea, se crede ca versiunile
           recente ale po4a trateaza in mod corespunzator <?>irurile
           duplicate, astfel incat ar trebui sa raporta<?>i orice problema
           ramasa pe care o pute<?>i intalni.

   Revizuirea fi<?>ierelor produse de po4a-gettextize
       Orice fi<?>ier produs de po4a-gettextize trebuie revizuit manual, chiar
       <?>i atunci cand scriptul se incheie cu succes. Ar trebui sa trece<?>i
       cu vederea fi<?>ierul PO, asigurandu-va ca msgid <?>i msgstr corespund
       efectiv. Nu este inca necesar sa va asigura<?>i ca traducerea este
       perfect corecta, deoarece toate intrarile sunt oricum marcate ca
       traduceri neclare. Trebuie doar sa verifica<?>i daca exista probleme
       evidente de potrivire, deoarece traducerile cu potrivire proasta vor fi
       abandonate in etapele urmatoare, in timp ce ceea ce dori<?>i, este sa
       le salva<?>i.

       Din fericire, acest pas nu necesita cunoa<?>terea limbilor <?>inta,
       deoarece dori<?>i doar sa recunoa<?>te<?>i elemente similare in fiecare
       msgid <?>i msgstr corespunzator. In calitate de vorbitor de franceza,
       engleza <?>i ceva germana, pot face acest lucru cel pu<?>in pentru
       toate limbile europene, chiar daca nu pot spune un cuvant din
       majoritatea acestor limbi. Uneori reu<?>esc sa detectez probleme de
       potrivire in limbile non-latine uitandu-ma la lungimea <?>irurilor de
       caractere, la structura frazelor (se potrive<?>te cantitatea de semne
       de interoga<?>ie?) <?>i la alte indicii, dar prefer ca altcineva sa
       revizuiasca aceste limbi.

       Daca detecta<?>i o nepotrivire, edita<?>i fi<?>ierele original <?>i de
       traducere ca <?>i cum po4a-gettextize ar fi raportat o eroare <?>i
       incerca<?>i din nou. Odata ce ave<?>i un fi<?>ier PO decent pentru
       traducerea dvs. anterioara, face<?>i o copie de rezerva a acestuia pana
       cand po4a func<?>ioneaza corect.

   Ruland po4a pentru prima data
       Cel mai simplu mod de a configura po4a este sa scrie<?>i un fi<?>ier de
       configurare po4a.conf <?>i sa utiliza<?>i programul integrat po4a
       (po4a-updatepo <?>i po4a-translate sunt depreciate). Va rugam sa
       consulta<?>i sec<?>iunea ,,FI<?>IERUL DE CONFIGURARE" din
       documenta<?>ia po4a(1) pentru mai multe detalii.

       Cand po4a ruleaza pentru prima data, versiunea curenta a documentelor
       principale va fi utilizata pentru a actualiza fi<?>ierele PO care
       con<?>in traducerile vechi pe care le-a<?>i salvat prin
       ,,gettextizare". Acest lucru poate dura destul de mult timp, deoarece
       multe dintre msgid-urile de la ,,gettextizare" nu corespund exact
       elementelor din fi<?>ierul POT construit din fi<?>ierele principale
       recente. Acest lucru for<?>eaza gettext sa caute cel mai apropiat
       folosind un algoritm costisitor de proximitate a <?>irurilor. De
       exemplu, prima rulare a traducerii in franceza a documenta<?>iei Perl
       (fi<?>ier PO de 5,5 MB) a durat aproximativ 48 de ore (da, doua zile),
       in timp ce cele ulterioare dureaza doar cateva secunde.

   Trecerea traducerilor dvs. in produc<?>ie
       Dupa aceasta prima execu<?>ie, fi<?>ierele PO sunt gata pentru a fi
       revizuite de traducatori. Toate intrarile au fost marcate ca
       aproximative (fuzzy) in fi<?>ierul PO de catre po4a-gettextization,
       for<?>and revizuirea lor atenta inainte de utilizare. Traducatorii
       trebuie sa examineze fiecare intrare pentru a verifica daca traducerea
       salvata corespunde de fapt textului original actual, sa actualizeze
       traducerea in func<?>ie de necesita<?>i <?>i sa elimine marcajele de
       traducere aproximativa.

       Odata ce sunt eliminate suficiente marcaje ,,fuzzy" (de traducere
       aproximativa), po4a va incepe sa genereze fi<?>ierele de traducere pe
       disc <?>i sunte<?>i gata sa trece<?>i fluxul de lucru de traducere la
       produc<?>ie. Unele proiecte considera ca este util sa se bazeze pe
       weblate pentru coordonarea intre traducatori <?>i intre<?>inatori, dar
       acest lucru depa<?>e<?>te domeniul de aplicare al po4a.

CONSULTA<?>I <?>I
       po4a(1), po4a-normalize(1), po4a-translate(1), po4a-updatepo(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-GETTEXTIZE.1P(1)