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


NUME
       Locale::Po4a::TeX - converte<?>te documente TeX <?>i derivate 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::TeX este un modul care ajuta la traducerea documentelor
       TeX in alte limbi [umane]. De asemenea, poate fi folosit ca baza pentru
       a construi module pentru documente bazate pe TeX.

       Utilizatorii ar trebui sa foloseasca probabil modulul LaTeX, care
       mo<?>tene<?>te din modulul TeX <?>i con<?>ine defini<?>iile comenzilor
       LaTeX comune.

TRADUCEREA CU PO4A::TEX
       Acest modul poate fi utilizat direct pentru a gestiona documente TeX
       generice. Acesta va impar<?>i documentul in blocuri mai mici
       (paragrafe, blocuri verbatim sau chiar mai mici, cum ar fi titluri sau
       indexuri).

       Exista cateva op<?>iuni (descrise in sec<?>iunea urmatoare) care pot
       personaliza acest comportament. Daca acest lucru nu se potrive<?>te
       formatului dvs. de document, sunte<?>i incurajat sa scrie<?>i propriul
       dvs. modul derivat din acesta, pentru a descrie detaliile formatului
       dvs. Pentru descrierea procesului, consulta<?>i sec<?>iunea SCRIEREA
       MODULELOR DERIVATE de mai jos.

       Acest modul poate fi, de asemenea, personalizat prin linii care incep
       cu ,,% po4a:" in fi<?>ierul TeX. Acest proces este descris in
       sec<?>iunea PERSONALIZARE INLINE.

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.

       no_wrap
           Lista separata prin virgule de medii care nu ar trebui sa fie
           redimensionate.

           Re<?>ine<?>i ca exista o diferen<?>a intre mediile verbatim <?>i
           no_wrap. Nu exista o analiza a comenzilor <?>i comentariilor in
           blocurile verbatim.

           Daca acest mediu nu a fost deja inregistrat, po4a va considera ca
           acest mediu nu prime<?>te niciun parametru.

       exclude_include
           Lista de fi<?>iere separate prin doua puncte (:) care nu ar trebui
           incluse de ,,\input" <?>i ,,\include".

       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.

       verbatim
           Lista de medii separate prin virgule care ar trebui sa fie luate ca
           verbatim.

           Daca acest mediu nu a fost deja inregistrat, po4a va considera ca
           acest mediu nu prime<?>te niciun parametru.

       Utiliza<?>i aceste op<?>iuni pentru a trece peste comportamentul
       implicit al comenzilor definite.

PERSONALIZARE INLINE
       Modulul TeX poate fi personalizat cu linii care incep cu % po4a:.
       Aceste linii sunt interpretate ca fiind comenzi pentru analizator. Sunt
       recunoscute urmatoarele comenzi:

       % po4a: command comanda1 alias comanda2
           Indica faptul ca argumentele comenzii comanda1 trebuie sa fie
           tratate ca argumente ale comenzii comanda2.

       % po4a: command comanda1 parametrii
           Aceasta descrie in detaliu parametrii comenzii comanda1. Aceste
           informa<?>ii vor fi utilizate pentru a verifica numarul de
           argumente <?>i tipurile acestora.

           Pute<?>i preceda comanda comanda1 cu

           un asterisc (*)
               po4a va extrage aceasta comanda din paragrafe (daca este
               situata la inceputul sau la sfar<?>itul unui paragraf).
               Traducatorii vor trebui apoi sa traduca parametrii care sunt
               marca<?>i ca traductibili.

           un plus (+)
               In ceea ce prive<?>te asteriscul, comanda va fi extrasa daca
               apare la o extremitate a unui bloc, dar parametrii nu vor fi
               tradu<?>i separat. Traducatorul va trebui sa traduca comanda
               concatenata cu to<?>i parametrii sai. Acest lucru pastreaza mai
               mult context <?>i este util pentru comenzile cu cuvinte mici in
               parametri, care pot avea mai multe sensuri (<?>i traduceri).

               Nota: In acest caz, nu trebuie sa specifica<?>i care parametri
               sunt traductibili, dar po4a trebuie sa cunoasca tipul <?>i
               numarul parametrilor.

           un minus (-)
               In acest caz, comanda nu va fi extrasa din niciun bloc. Dar
               daca apare singura intr-un bloc, atunci numai parametrii
               marca<?>i ca traductibili vor fi prezenta<?>i traducatorului.
               Acest lucru este util pentru comenzile privind fonturile. In
               general, aceste comenzi nu ar trebui sa fie separate de
               paragraful lor (pentru a pastra contextul), dar nu exista
               niciun motiv pentru a enerva traducatorul cu ele daca un intreg
               <?>ir de caractere este inclus intr-o astfel de comanda.

           Argumentul parametrii este un set de [] (pentru a indica un
           argument op<?>ional) sau {} (pentru a indica un argument
           obligatoriu).  Pute<?>i plasa un semn de subliniere (_) intre
           aceste paranteze pentru a indica faptul ca parametrul trebuie sa
           fie tradus. De exemplu:
            % po4a: command *chapter [_]{_}

           Acest lucru indica faptul ca comanda ,,chapter" are doi parametri:
           unul op<?>ional (titlu scurt) <?>i unul obligatoriu, care trebuie
           sa fie tradu<?>i amandoi.  Daca dori<?>i sa specifica<?>i ca
           comanda ,,href" are doi parametri obligatorii, ca nu dori<?>i sa
           traduce<?>i adresa URL (primul parametru) <?>i ca nu dori<?>i ca
           aceasta comanda sa fie separata de paragraful sau (care permite
           traducatorului sa mute legatura in fraza), pute<?>i utiliza:
            % po4a: command -href {}{_}

           In acest caz, informa<?>iile care indica ce argumente trebuie
           traduse sunt utilizate numai daca un paragraf este compus numai din
           aceasta comanda ,,href".

       % po4a: environment mediu parametrii
           Aceasta define<?>te parametrii accepta<?>i de mediul mediu <?>i ii
           specifica pe cei care trebuie tradu<?>i.  Aceasta informa<?>ie este
           utilizata ulterior pentru a verifica numarul de argumente ale
           comenzii ,,\begin".  Sintaxa argumentului parametrii este aceea<?>i
           cu cea descrisa pentru celelalte comenzi.  Primul parametru al
           comenzii ,,\begin" este numele mediului.  Acest parametru nu
           trebuie sa fie specificat in lista de parametri. Iata cateva
           exemple:
            % po4a: environment multicols {}
            % po4a: environment equation

           In ceea ce prive<?>te comenzile, mediu poate fi precedat de un plus
           (+) pentru a indica faptul ca comanda ,,\begin" trebuie tradusa cu
           toate argumentele sale.

       % po4a: separator mediu "expresie-regulata"
           Indica faptul ca un mediu ar trebui sa fie divizat in conformitate
           cu expresia regulata data.

           Expresia regulata este delimitata prin ghilimele. Ea nu trebuie sa
           creeze nicio referin<?>a inapoi. Ar trebui sa utiliza<?>i (?:) daca
           ave<?>i nevoie de un grup. De asemenea, poate avea nevoie de unele
           eludari.

           De exemplu, modulul LaTeX utilizeaza expresia regulata
           ,,(?:&|\\\\)" pentru a traduce separat fiecare celula a unui tabel
           (liniile sunt separate prin ,,\\", iar celulele prin ,,&").

           No<?>iunea de mediu este extinsa la tipul afi<?>at in fi<?>ierul
           PO. Aceasta poate fi utilizata pentru a diviza pe ,,\\\\" in primul
           argument obligatoriu al comenzii title. In acest caz, mediul este
           title{#1}.

       % po4a: verbatim environment mediu
           Indica faptul ca mediu este un mediu verbatim. Comentariile <?>i
           comenzile vor fi ignorate in acest mediu.

           Daca acest mediu nu a fost deja inregistrat, po4a va considera ca
           acest mediu nu prime<?>te niciun parametru.

SCRIEREA MODULELOR DERIVATE
       pre_trans
       post_trans
       add_comment
           Adauga un <?>ir de caractere ca un comentariu care sa fie adaugat
           in jurul urmatorului element tradus. Acest lucru este util mai ales
           pentru modulul texinfo, deoarece comentariile sunt gestionate
           automat in TeX.

       translate
           Modul de invaluire in jurul traducerii Transtractor, cu filtre de
           pre <?>i post-procesare.

           Comentariile unui paragraf sunt inserate ca un comentariu PO pentru
           primul <?>ir tradus din acest paragraf.

       get_leading_command($buffer)
           Aceasta func<?>ie returneaza:

           Un nume de comanda
               Daca nu se gase<?>te nicio comanda la inceputul tamponului dat,
               acest <?>ir va fi gol. Sunt luate in considerare numai
               comenzile care pot fi separate. Seria %separated_command
               con<?>ine lista acestor comenzi.

           O varianta
               Aceasta indica daca se utilizeaza o varianta. De exemplu, un
               asterisc (*) poate fi adaugat la sfar<?>itul sec<?>iunilor de
               comanda pentru a specifica faptul ca acestea nu trebuie
               numerotate. In acest caz, acest camp va con<?>ine ,,*". Daca nu
               exista nicio varianta, campul este un <?>ir gol.

           O matrice de cupluri (tip de argument, argument)
               Tipul de argument poate fi ,,{" (pentru argumente obligatorii)
               sau ,,[" (pentru argumente op<?>ionale).

           Tamponul ramas
               Restul tamponului dupa eliminarea acestei comenzi principale
               <?>i a argumentelor sale. Daca nu se gase<?>te nicio comanda,
               tamponul original nu este atins <?>i este returnat in acest
               camp.

       get_trailing_command($buffer)
           La fel ca get_leading_command, dar pentru comenzi la sfar<?>itul
           unui tampon.

       translate_buffer
           Traduce recursiv un tampon prin separarea comenzilor anterioare
           <?>i ulterioare (cele care trebuie traduse separat) din tampon.

           Daca o func<?>ie este definita in %translate_buffer_env pentru
           mediul curent, aceasta func<?>ie va fi utilizata pentru a traduce
           tamponul in loc de translate_buffer().

       read
           Supraincarca func<?>ia read() a Transtractor.

       read_file
           Cite<?>te recursiv un fi<?>ier, adaugand fi<?>ierele incluse care
           nu sunt listate in matricea @exclude_include. Fi<?>ierele incluse
           sunt cautate folosind comanda kpsewhich din biblioteca Kpathsea.

           Cu excep<?>ia par<?>ii de includere a fi<?>ierului, este o simpla
           taiere <?>i lipire (o copie) din citirea lui Transtractor.

       parse_definition_file
           Subrutina pentru analizarea unui fi<?>ier cu directive po4a
           (defini<?>ii pentru comenzi noi).

       parse_definition_line
           Analizeaza o linie de defini<?>ie de forma ,,% po4a: ".

           Pentru mai multe detalii, consulta<?>i sec<?>iunea PERSONALIZARE
           INLINE.

       is_closed
       parse
       docheader

FUNC<?>II INTERNE utilizate pentru scrierea analizatorilor derivativi
       Func<?>iile de comanda <?>i de mediu primesc urmatoarele argumente (in
       plus fa<?>a de obiectul $self):

       Un nume de comanda
       O varianta
       O matrice de cupluri (tip, argument)
       Mediul actual

       Primele 3 argumente sunt extrase de get_leading_command sau
       get_trailing_command.

       Func<?>iile de comanda <?>i mediu returneaza traducerea comenzii cu
       argumentele sale <?>i un nou mediu.

       Func<?>iile de mediu sunt apelate atunci cand este gasita o comanda
       ,,\begin". Acestea sunt apelate cu comanda ,,\begin" <?>i argumentele
       sale.

       Modulul TeX propune doar o func<?>ie de comanda <?>i o func<?>ie de
       mediu: generic_command <?>i generic_environment.

       generic_command utilizeaza informa<?>iile specificate de catre
       register_generic_command sau prin adaugarea defini<?>iei la fi<?>ierul
       TeX:
        % po4a: command comanda1 parametri

       generic_environment utilizeaza informa<?>iile specificate de catre
       register_generic_environment sau prin adaugarea defini<?>iei la
       fi<?>ierul TeX:
        % po4a: environment mediu parametri

       Ambele func<?>ii vor traduce numai parametrii care au fost
       specifica<?>i ca fiind traductibili (cu un ,,_"). generic_environment
       va adauga numele mediului la stiva de medii, iar generic_command va
       adauga numele comenzii urmat de un identificator al parametrului (cum
       ar fi {#7} sau [#2]).

STAREA ACESTUI MODUL
       Acest modul necesita mai multe teste.

       Acesta a fost testat pe o carte <?>i cu documenta<?>ia Python.

LISTA CU LUCRURI DE FACUT
       Detectarea automata a comenzilor noi
           Modulul TeX ar putea analiza argumentele noii comenzi <?>i ar putea
           incerca sa ghiceasca numarul de argumente, tipul acestora <?>i daca
           ar trebui sau nu sa fie traduse.

       Traducerea separatorului de mediu
           Atunci cand \item este utilizat ca separator de mediu, argumentul
           ,,item" este ata<?>at la urmatorul <?>ir de caractere.

       Unele comenzi ar trebui adaugate la stiva de mediu
           Aceste comenzi trebuie sa fie specificate prin cupluri.  Aceasta
           poate fi utilizata pentru a specifica comenzile care incep sau
           incheie un mediu verbatim.

       Altele
           Diverse alte puncte sunt etichetate TODO in codul-sursa.

ERORI CUNOSCUTE
       Diverse puncte sunt etichetate FIXME in codul-sursa.

CONSULTA<?>I <?>I
       Locale::Po4a::LaTeX(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORI
        Nicolas Francois <nicolas.francois@centraliens.net>

DREPTURI DE AUTOR <?>i LICEN<?>A
       Drepturi de autor (C) 2004, 2005 Nicolas FRANCOIS
       <nicolas.francois@centraliens.net>.

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