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


NUME
       Locale::Po4a::AsciiDoc - converte<?>te documente AsciiDoc 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::AsciiDoc este un modul care ajuta la traducerea
       documenta<?>iei in formatul AsciiDoc.

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

       definitions
           Numele unui fi<?>ier care con<?>ine defini<?>ii pentru po4a, astfel
           cum sunt definite in sec<?>iunea PERSONALIZARE INLINE. Pute<?>i
           utiliza aceasta op<?>iune daca nu este posibil sa introduce<?>i
           defini<?>iile in documentul tradus.

           Intr-un fi<?>ier de defini<?>ii, liniile nu trebuie sa inceapa cu
           doua bare oblice, ci direct cu po4a:.

       entry
           Lista separata prin spa<?>ii a intrarilor de atribute pe care
           dori<?>i sa le traduce<?>i. In mod implicit, nicio intrare de
           atribut nu poate fi tradusa.

       macro
           Lista de defini<?>ii de macro-uri separate prin spa<?>iu.

       style
           Lista de defini<?>ii de stiluri separate prin spa<?>ii.

       forcewrap
           Activeaza incadrarea automata a liniilor in blocuri non-verbatim,
           chiar daca rezultatul ar putea fi interpretat gre<?>it de
           formatatori AsciiDoc.

           In mod implicit, po4a nu va incadra fi<?>ierele AsciiDoc produse
           deoarece este necesara o inspec<?>ie manuala pentru a se asigura ca
           incadrarea nu modifica formatarea. Lua<?>i in considerare, de
           exemplu, urmatorul element de lista:

            * o propozi<?>ie lunga care se termina cu un numar 1. O a doua propozi<?>ie.

           Daca incadrarea conduce la urmatoarea prezentare, elementul este
           impar<?>it intr-o sublista numerotata. Pentru a inrauta<?>i
           lucrurile, numai vorbitorii limbii utilizate in traducere pot
           inspecta situa<?>ia.

            * o propozi<?>ie lunga care se termina cu un numar
              1. O a doua propozi<?>ie.

           Re<?>ine<?>i ca neincluderea fi<?>ierelor produse de po4a nu ar
           trebui sa fie o problema, deoarece aceste fi<?>iere sunt menite sa
           fie prelucrate automat. Oricum, acestea nu ar trebui sa fie
           considerate fi<?>iere sursa.

           Cu aceasta op<?>iune, po4a va produce fi<?>iere AsciiDoc mai
           aspectuoase, dar poate duce la rezultate formatate eronat.

       noimagetargets
           In mod implicit, <?>intele imaginilor bloc sunt traductibile pentru
           a oferi posibilitatea de a face con<?>inutul sa indice imagini
           traduse. Acest lucru poate fi oprit prin definirea acestei
           op<?>iuni.

       tablecells
           Aceasta op<?>iune este un fanion care permite segmentarea
           sub-tabelului in con<?>inutul celulelor. Segmentarea este limitata
           la con<?>inutul celulei, fara nicio analiza in interiorul acesteia.

       compat
           Schimba regulile de analizare pentru compatibilitate cu diferite
           instrumente. Op<?>iunile disponibile sunt ,,asciidoc" sau
           ,,asciidoctor". Asciidoctor are reguli de parsare mai stricte, cum
           ar fi egalitatea lungimii blocurilor de deschidere <?>i de
           inchidere.

       nolinting
           Dezactiveaza mesajele de verificare. Atunci cand codul sursa nu
           poate fi fixat pentru o structura mai clara a documentului, aceste
           mesaje sunt inutile.

       cleanspaces
           Elimina spa<?>iile suplimentare din segmentele sursa in modul
           ,,no-wrap". Acest lucru este util atunci cand instrumentele de
           traducere sunt sensibile la numarul de spa<?>ii.

       yfm_keys
           Lista de chei separate prin virgule care urmeaza sa fie procesate
           pentru traducere in sec<?>iunea de prezentare (introductiva) YAML.
           Toate celelalte chei sunt ignorate. Cheile sunt comparate cu o
           potrivire sensibila la majuscule. Daca yfm_paths <?>i yfm_keys sunt
           utilizate impreuna, valorile sunt incluse daca se potrivesc cu cel
           pu<?>in una dintre op<?>iuni. Valorile din matrice sunt intotdeauna
           traduse, cu excep<?>ia cazului in care este furnizata op<?>iunea
           yfm_skip_array.

       yfm_skip_array
           Nu traduce valorile matricei din sec<?>iunea de prezentare YAML.

       yfm_paths
           Lista separata prin virgule de rute hash care urmeaza sa fie
           procesate pentru extragere in sec<?>iunea de prezentare YAML, toate
           celelalte rute sunt ignorate. Rutele sunt comparate cu o potrivire
           sensibila la majuscule. Daca yfm_paths <?>i yfm_keys sunt utilizate
           impreuna, valorile sunt incluse daca sunt potrivite cu cel pu<?>in
           una dintre op<?>iuni. Valorile matricelor sunt intotdeauna
           returnate, cu excep<?>ia cazului in care este furnizata op<?>iunea
           yfm_skip_array.

PERSONALIZARE INLINE
       Modulul AsciiDoc poate fi personalizat cu linii care incep cu //po4a:.
       Aceste linii sunt interpretate drept comenzi pentru analizator. Sunt
       recunoscute urmatoarele comenzi:

       //po4a: macro nume[lista-atribute]
           Acesta descrie in detaliu parametrii unei macro; nume trebuie sa
           fie un nume de macro valid <?>i se termina cu un caracter de
           subliniere daca <?>inta trebuie tradusa.

           Argumentul lista-atribute este o lista separata prin virgule care
           con<?>ine informa<?>ii despre argumentele traductibile. Aceasta
           lista con<?>ine fie numere, pentru a defini parametrii
           pozi<?>ionali, fie atribute numite.

           Daca un semn plus (+) este anexat la nume, atunci macro-ul <?>i
           argumentele sale sunt traduse ca un intreg. Nu este necesara
           definirea listei de atribute in acest caz, dar parantezele trebuie
           sa fie prezente.

       //po4a: style [lista-atribute]
           Aceasta descrie in detaliu care atribute ale unui stil trebuie
           traduse.

           Argumentul lista-atribute este o lista separata prin virgule care
           con<?>ine informa<?>ii despre argumentele traductibile. Aceasta
           lista con<?>ine fie numere, pentru a defini parametrii
           pozi<?>ionali, fie atribute numite. Primul atribut este numele
           stilului, acesta nu va fi tradus.

           Daca numele stilului este precedat de un semn plus (+), atunci
           lista de atribute este tradusa ca intreg. Nu este necesar sa se
           defineasca atribute traductibile.

           Daca numele stilului este precedat de un semn minus (-), atunci
           acest atribut nu este tradus.

           Daca un semn de procent (%) este adaugat la numele stilului, atunci
           stilul este procesat ca verbatim. Liniile din paragraf sau bloc ale
           unui astfel de stil sunt pastrate in fi<?>ierele po, iar intrarile
           corespunzatoare sunt marcate ca ,,no-wrap".

       //po4a: entry nume
           Aceasta declara o intrare de atribut ca fiind traductibila. In mod
           implicit, acestea nu sunt traduse.

STAREA ACESTUI MODUL
       Testat cu succes pe fi<?>iere AsciiDoc simple.

AUTORI
        Nicolas Francois <nicolas.francois@centraliens.net>
        Denis Barbier <barbier@linuxfr.org>

DREPTURI DE AUTOR <?>i LICEN<?>A
        Drepturi de autor (C) 2005-2008 Nicolas FRANCOIS <nicolas.francois@centraliens.net>.
        Drepturi de autor (C) 2012 Denis BARBIER <barbier@linuxfr.org>.
        Drepturi de autor (C) 2017 Martin Quinson <mquinson#debian.org>.

       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::ASCIIDOC.3PM(1)