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


NUME
       Locale::Po4a::Man - converte<?>te pagini de manual din/in fi<?>iere PO

DESCRIERE
       Scopul proiectului po4a (PO pentru orice) este de a u<?>ura traducerile
       (<?>i mai interesant, intre<?>inerea traducerilor) folosind instrumente
       gettext in domenii in care nu erau a<?>teptate, cum ar fi
       documenta<?>ia.

       Locale::Po4a::Man este un modul care ajuta la traducerea
       documenta<?>iei in format nroff (limba paginilor de manual) in alte
       limbi [umane].

TRADUCEREA CU PO4A::MAN
       Acest modul incearca din rasputeri sa faca via<?>a traducatorului mai
       u<?>oara. Pentru aceasta, textul prezentat traducatorilor nu este o
       copie literala a textului gasit in pagina de manual. Intr-adevar,
       par<?>ile mai grosolane ale formatului nroff sunt ascunse, astfel incat
       traducatorii sa nu se poata incurca cu ele.

   Incadrarea textului
       Paragrafele neindentate sunt in mod automat re-incadrate pentru
       traducator. Acest lucru poate duce la unele diferen<?>e minore in
       rezultatul generat, deoarece regulile de reformulare utilizate de groff
       nu sunt foarte clare. De exemplu, doua spa<?>ii dupa o paranteza sunt
       uneori pastrate.

       Oricum, diferen<?>a va fi doar in ceea ce prive<?>te pozi<?>ia
       spa<?>iilor suplimentare in paragraful incadrat, <?>i cred ca merita.

   Specificarea fontului
       Prima modificare se refera la specifica<?>iile de schimbare a fontului.
       In nroff, exista mai multe modalita<?>i de a specifica daca un anumit
       cuvant ar trebui sa fie scris cu litere mici, aldine sau cursive. In
       textul de tradus, exista o singura modalitate, imprumutata din formatul
       POD (documenta<?>ia in linie Perl):

       I<text> -- text cursiv
           echivalent cu \fItext\fP sau ".I text"

       B<text> -- text aldin
           echivalent cu \fBtext\fP sau ".B text"

       R<text> -- text normal (roman)
           echivalent cu \fRtext\fP

       CW<text> -- text cu la<?>ime constanta
           echivalent cu \f(CWtext\fP sau ".CW text"

       Observa<?>ie: Aspectul CW al fontului nu este disponibil pentru toate
       dispozitivele Groff. Nu este recomandata utilizarea acestuia. Acesta
       este furnizat pentru confortul dumneavoastra.

   Transliterarea automata a caracterelor
       Po4a translitera automat unele caractere pentru a facilita traducerea
       sau revizuirea traducerii. Aici este lista transliterarilor:

       cratime
           Cratimele (-) <?>i semnele minus (\-) din paginile de manual sunt
           toate transliterate ca liniu<?>e simple (-) in fi<?>ierul PO. Apoi,
           toate liniu<?>ele sunt transliterate in semne minus roff (\-)
           atunci cand traducerea este inserata in documentul de ie<?>ire.

           Traducatorii pot for<?>a o cratima prin utilizarea glifului roff
           ,,\[hy]" in traducerile lor.

       spa<?>ii rigide
           Traducatorii pot utiliza spa<?>ii fara pauza in traducerile lor.
           Aceste spa<?>ii rigide (0xA0 in latin1) vor fi transliterate
           intr-un spa<?>iu fara pauza roff ('\ ').

       translitera<?>ii de ghilimele
           Ghilimelele `` <?>i '' sunt transliterate in \*(lq <?>i respectiv
           \*(rq.

           Pentru a evita aceste transliterari, traducatorii pot introduce un
           caracter roff de la<?>ime zero (de exemplu, folosind ,,\&" sau,
           respectiv, ,,\&").

   Introducerea ,,<" <?>i ,,>" in traduceri
       Deoarece aceste caractere sunt utilizate pentru a delimita par<?>ile in
       care se modifica fontul, nu le pute<?>i utiliza textual. Utiliza<?>i in
       schimb E<lt> <?>i E<gt> (ca in POD, inca o data).

OP<?>IUNI ACCEPTATE DE ACEST MODUL
       Acestea sunt op<?>iunile particulare ale acestui modul:

       debug
           Activeaza depanarea pentru unele mecanisme interne ale acestui
           modul. Utiliza<?>i sursa pentru a vedea care par<?>i pot fi
           depanate.

       verbose
           Mare<?>te nivelul de detaliere al ie<?>irii.

       groff_code
           Aceasta op<?>iune controleaza comportamentul modulului atunci cand
           intalne<?>te o sec<?>iune .de, .ie sau .if. Aceasta poate lua
           urmatoarele valori:

           fail
               Aceasta este valoarea implicita. Modulul va e<?>ua atunci cand
               este intalnita o sec<?>iune .de, .ie sau .if.

           verbatim
               Indica faptul ca sec<?>iunile .de, .ie sau .if trebuie copiate
               ca atare din original in documentul tradus.

           translate
               Indica faptul ca sec<?>iunile .de, .ie sau .if vor fi propuse
               pentru traducere. Ar trebui sa utiliza<?>i aceasta op<?>iune
               numai daca un <?>ir traductibil este con<?>inut in una dintre
               aceste sec<?>iuni. In caz contrar, ar trebui preferata
               op<?>iunea verbatim.

       generated
           Aceasta op<?>iune specifica faptul ca fi<?>ierul a fost generat
           <?>i ca po4a nu trebuie sa incerce sa detecteze daca paginile de
           manual au fost generate din alt format. Aceasta op<?>iune este
           obligatorie pentru a utiliza po4a pe paginile de manual generate.
           Re<?>ine<?>i ca traducerea paginilor generate in locul celor sursa
           este adesea mai fragila <?>i, prin urmare, o idee proasta.

       mdoc
           Aceasta op<?>iune este utila numai pentru paginile mdoc.

           Aceasta selecteaza un suport mai strict al formatului mdoc,
           spunandu-i lui po4a sa nu traduca sec<?>iunea ,,NAME". Paginile
           mdoc a caror sec<?>iune ,,NAME" este tradusa nu vor genera niciun
           antet sau nota de subsol.

           Conform paginii groff_mdoc, sec<?>iunile NAME, SYNOPSIS <?>i
           DESCRIPTION sunt obligatorii.  Nu exista probleme cunoscute cu
           sec<?>iunile SYNOPSIS sau DESCRIPTION traduse, dar pute<?>i
           specifica aceste sec<?>iuni <?>i in acest mod:
            -o mdoc=NAME,SYNOPSIS,DESCRIPTION

           Aceasta problema mdoc poate fi rezolvata <?>i cu un addendum ca
           acesta:
            PO4A-HEADER:mode=before;position=^.Dd
            .TH DOCUMENT_TITLE 1 ,,Luna ziua, anul" OS ,,Numele sec<?>iunii"

       Urmatoarele op<?>iuni specifica comportamentul unei macrodefini<?>ii
       definite de utilizator (cu o cerere .de) sau al unei macrodefini<?>ii
       clasice care nu este acceptata de po4a. Acestea iau ca argument o lista
       de nume de macrodefini<?>ii separate prin virgula. De exemplu:

        -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX

       Nota: daca o macrodefini<?>ie nu este acceptata de po4a <?>i daca
       considera<?>i ca este o macrodefini<?>ie roff standard, trebuie sa o
       trimite<?>i echipei de dezvoltare po4a.

       untranslated
           untranslated indica faptul ca aceasta macrodefini<?>ie (sau
           argumentele sale) nu trebuie sa fie tradusa.

       noarg
           noarg este ca untranslated, cu excep<?>ia faptului ca po4a va
           verifica daca nu este adaugat niciun argument la aceasta
           macrodefini<?>ie.

       translate_joined
           translate_joined indica faptul ca po4a trebuie sa propuna
           traducerea argumentelor macrodefini<?>iei.

       translate_each
           Cu translate_each, argumentele vor fi, de asemenea, propuse pentru
           traducere, doar ca fiecare va fi tradus separat.

       no_wrap
           Aceasta op<?>iune prime<?>te ca argument o lista de cupluri
           separate prin virgula begin:end, unde begin <?>i end sunt comenzi
           care delimiteaza inceputul <?>i sfar<?>itul unei sec<?>iuni care nu
           ar trebui sa fie reincadrata.

           Nota: nu se efectueaza niciun test pentru a se asigura ca o comanda
           end corespunde comenzii sale begin; orice comanda de sfar<?>it
           opre<?>te modul no_wrap. Daca ave<?>i o macrocomanda begin
           (respectiv end) care nu are end (respectiv begin), pute<?>i
           specifica o macrocomanda end ( precum fi) sau begin (precum nf)
           existenta ca o contrapartida. Aceste macrocomenzi (<?>i argumentele
           lor) nu vor fi traduse.

       inline
           Aceasta op<?>iune specifica o lista de macro-uri separate prin
           virgula care nu trebuie sa desparta paragraful curent. <?>irul de
           caractere de tradus va con<?>ine atunci foo <.bar baz qux> quux,
           unde bar este comanda care trebuie introdusa, iar baz qux
           argumentele sale.

       unknown_macros
           Aceasta op<?>iune indica modul in care po4a ar trebui sa se
           comporte atunci cand este gasita o macrocomanda necunoscuta. In mod
           implicit, po4a e<?>ueaza cu un avertisment. Aceasta poate lua
           urmatoarele valori: failed (valoarea implicita), untranslated,
           noarg, translate_joined sau translate_each ( a se vedea mai sus
           pentru o explica<?>ie a acestor valori).

CREAREA DE PAGINI DE MANUAL CONFORME CU PO4A::MAN
       Acest modul este inca foarte limitat, <?>i va fi intotdeauna, deoarece
       nu este un interpret nroff real. Ar fi posibil sa realizam un interpret
       nroff real, pentru a permite autorilor sa utilizeze toate
       macrocomenzile existente sau chiar sa defineasca altele noi in paginile
       lor, dar nu am dorit acest lucru. Ar fi prea dificil <?>i am considerat
       ca nu este necesar. Ne gandim ca, daca autorii paginilor de manual
       doresc ca produsele lor sa fie traduse, ar trebui sa se adapteze pentru
       a u<?>ura munca traducatorilor.

       A<?>adar, analizatorul man implementat in po4a are unele limitari
       cunoscute pe care nu prea suntem inclina<?>i sa le corectam <?>i care
       vor constitui unele capcane pe care va trebui sa le evita<?>i daca
       dori<?>i ca traducatorii sa aiba grija de documenta<?>ia dumneavoastra.

   Nu programa<?>i in nroff
       nroff este un limbaj de programare complet, cu defini<?>ie macro,
       condi<?>ionale <?>i a<?>a mai departe. Deoarece acest analizator nu
       este un interpret nroff complet, el va e<?>ua pe paginile care
       utilizeaza aceste facilita<?>i (exista aproximativ 200 de astfel de
       pagini pe calculatorul meu).

   Utiliza<?>i un set de macrocomenzi simplu
       Exista inca unele macrocomenzi care nu sunt acceptate de po4a::man.
       Acest lucru se datoreaza doar faptului ca nu am reu<?>it sa gasesc
       nicio documenta<?>ie despre acestea. Iata lista macrocomenzilor
       neacceptate utilizate pe calculatorul meu. Re<?>ine<?>i ca aceasta
       lista nu este exhaustiva, deoarece programul e<?>ueaza la prima
       macrocomanda neacceptata intalnita. Daca ave<?>i informa<?>ii despre
       unele dintre aceste macrocomenzi, voi adauga cu placere suport pentru
       acestea. Din cauza acestor macrocomenzi, aproximativ 250 de pagini din
       calculatorul meu sunt inaccesibile pentru po4a::man.

        ..               ."              .AT             .b              .bank
        .BE              ..br            .Bu             .BUGS           .BY
        .ce              .dbmmanage      .do                             .En
        .EP              .EX             .Fi             .hw             .i
        .Id              .l              .LO             .mf
        .N               .na             .NF             .nh             .nl
        .Nm              .ns             .NXR            .OPTIONS        .PB
        .pp              .PR             .PRE            .PU             .REq
        .RH              .rn             .S<             .sh             .SI
        .splitfont       .Sx             .T              .TF             .The
        .TT              .UC             .ul             .Vb             .zZ

   Ascunderea textului de po4a
       Uneori, autorul <?>tie ca unele par<?>i nu sunt traductibile <?>i nu ar
       trebui extrase de po4a. De exemplu, o op<?>iune poate accepta un
       argument other, iar other poate aparea <?>i ca ultimul element al unei
       liste. In primul caz, other nu ar trebui sa poata fi tradus. Iar in al
       doilea caz, other ar trebui sa fie tradus.

       In acest caz, autorul poate evita po4a pentru a extrage unele <?>iruri
       de caractere, folosind unele construc<?>ii groff speciale:

        .if !'po4a'hide' .B other

       (aceasta va necesita op<?>iunea -o groff_code=verbatim)

       De asemenea, poate fi definit o noua macrocomanda pentru a automatiza
       acest lucru:
        .de IR_untranslated
        .    IR \\$@
        ..

        .IR_untranslated \-q ", " \-\-quiet

       (aceasta va necesita op<?>iunile -o groff_code=verbatim <?>i -o
       untranslated=IR_untranslated; cu aceasta construc<?>ie, condi<?>ionalul
       .if !'po4a'hide' nu este strict necesar deoarece po4a nu va analiza
       interiorul defini<?>iei macro)

       sau folosind un alias:
        .als IR_untranslated IR

        .IR_untranslated \-q ", " \-\-quiet

       Acesta va necesita op<?>iunea -o untranslated=als,IR_untranslated.

   Concluzie
       Pentru a rezuma aceasta sec<?>iune, pastra<?>i simplitatea <?>i nu
       incerca<?>i sa fi<?>i inteligen<?>i atunci cand va scrie<?>i paginile
       de manual. O mul<?>ime de lucruri sunt posibile in nroff <?>i nu sunt
       acceptate de acest analizator. De exemplu, nu incerca<?>i sa va
       juca<?>i cu \c pentru a intrerupe procesarea textului (a<?>a cum fac 40
       de pagini de pe calculatorul meu). Sau, asigura<?>i-va ca pune<?>i
       argumentele macro pe aceea<?>i linie cu macroul in sine. <?>tiu ca este
       valabil in nroff, dar ar complica prea mult analizatorul pentru a fi
       gestionat.

       Desigur, o alta posibilitate este de a utiliza un alt format, mai
       u<?>or de tradus (cum ar fi POD folosind po4a::pod, sau unul din
       familia XML cum ar fi SGML), dar datorita po4a::man nu mai este
       necesar. Acestea fiind spuse, daca formatul sursa al documenta<?>iei
       dvs. este POD sau XML, poate fi inteligent sa traduce<?>i formatul
       sursa <?>i nu acest format generat. In majoritatea cazurilor, po4a::man
       va detecta paginile generate <?>i va emite un avertisment. Acesta va
       refuza chiar sa proceseze paginile generate de POD, deoarece aceste
       pagini sunt gestionate perfect de po4a::pod <?>i deoarece omologul lor
       nroff define<?>te o mul<?>ime de macrocomenzi noi pentru care nu am
       vrut sa scriu suport. Pe calculatorul meu, 1432 din cele 4323 de pagini
       sunt generate de POD <?>i vor fi ignorate de po4a::man.

       In majoritatea cazurilor, po4a::man va detecta problema <?>i va refuza
       sa proceseze pagina, emi<?>and un mesaj adaptat. In unele cazuri rare,
       programul se va finaliza fara avertisment, dar rezultatul va fi
       gre<?>it. Astfel de cazuri sunt numite ,,erori" ;) Daca intalni<?>i un
       astfel de caz, asigura<?>i-va ca raporta<?>i acest lucru, impreuna cu o
       remediere atunci cand este posibil<?>

STAREA ACESTUI MODUL
       Acest modul poate fi utilizat pentru majoritatea paginilor de manual
       existente.

       Unele teste sunt efectuate in mod regulat pe cutii Linux:

       o   o treime din pagini sunt refuzate deoarece au fost generate
           dintr-un alt format acceptat de po4a (de exemplu, POD sau SGML).

       o   10% din paginile ramase sunt respinse cu o eroare (de exemplu,
           macrocomanda groff nu este acceptata).

       o   Apoi, mai pu<?>in de 1% din pagini sunt acceptate silen<?>ios de
           po4a, dar cu probleme semnificative (de exemplu, cuvinte lipsa sau
           cuvinte noi introduse)

       o   Celelalte pagini sunt, de obicei, tratate fara diferen<?>e mai
           importante decat diferen<?>ele de spa<?>iere sau de linie (probleme
           de font in mai pu<?>in de 10% din paginile procesate).

CONSULTA<?>I <?>I
       Locale::Po4a::Pod(3pm), Locale::Po4a::TransTractor(3pm), 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 (C) 2002-2008 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          LOCALE::PO4A::MAN.3PM(1)