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


NUME
       Locale::Po4a::Sgml - converte<?>te documente SGML 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::Sgml este un modul care ajuta la traducerea
       documenta<?>iei in format SGML in alte limbi [umane].

       Acest modul utilizeaza onsgmls(1) pentru a analiza fi<?>ierele SGML.
       Asigura<?>i-va ca acesta este instalat. De asemenea, asigura<?>i-va ca
       DTD-ul fi<?>ierelor SGML este instalat in sistem.

OP<?>IUNI ACCEPTATE DE ACEST MODUL
       debug
           Lista de cuvinte cheie separate prin spa<?>ii care indica categoria
           de mesaje suplimentare de depanare care ar trebui afi<?>ate.
           Valorile posibile sunt: "entities", "generic", "onsgml", "refs"
           <?>i "tag".

       verbose
           Ofera mai multe informa<?>ii despre ceea ce se intampla.

       translate
           Lista separata prin spa<?>ii de etichete suplimentare (pe langa
           cele furnizate de DTD) al caror con<?>inut ar trebui sa formeze un
           msgid suplimentar, adica care ar trebui tradus.

       section
           Lista separata prin spa<?>ii de etichete suplimentare (pe langa
           cele furnizate de DTD) care con<?>in alte etichete, unele dintre
           ele fiind din categoria translate.

       indent
           Lista de etichete separate prin spa<?>ii care maresc nivelul de
           indentare. Acest lucru va afecta indentarea in documentul rezultat.

       verbatim
           Aspectul din cadrul acestor etichete nu trebuie modificat.
           Paragraful nu va fi incadrat <?>i nu vor fi adaugate spa<?>ii
           suplimentare de indentare sau linii noi in scop cosmetic.

       empty
           Etichetele nu trebuie sa fie inchise.

       ignore
           Etichete ignorate <?>i considerate de po4a ca date simple de tip
           caracter. Aceasta inseamna ca ele pot face parte dintr-un msgid. De
           exemplu, <b> este un bun candidat pentru aceasta categorie,
           deoarece plasarea sa in sec<?>iunea translate ar crea un msgids
           numai cu con<?>inutul sau, (<?>i de obicei nu este o propozi<?>ie
           intreaga), ceea ce este gre<?>it.

       attributes
           O lista de atribute separate prin spa<?>ii care trebuie sa fie
           traduse. Pute<?>i specifica atributele dupa numele lor (de exemplu,
           "lang"), dar pute<?>i, de asemenea, sa le prefixa<?>i cu o ierarhie
           de etichete, pentru a specifica faptul ca acest atribut va fi
           tradus numai atunci cand se afla in eticheta specificata. De
           exemplu: "<bbb><aaa>lang" specifica faptul ca atributul lang va fi
           tradus numai daca se afla intr-un tag "<aaa>", care se afla intr-un
           tag "<bbb>". Numele etichetelor sunt de fapt expresii regulate,
           astfel incat pute<?>i scrie <?>i lucruri precum "<aaa|bbb>lang"
           pentru a traduce numai atributele "lang" care sunt intr-o eticheta
           "<aaa>" sau "<bbb>".

       qualify
           O lista de atribute separate prin spa<?>ii pentru care traducerea
           trebuie calificata prin numele atributului, adica textul extras
           pentru traducere va include atat numele atributului, cat <?>i
           valoarea acestuia. de exemplu, pentru o eticheta precum "<aaa
           lang_en="foo">" traducatorilor li se va prezenta <?>irul
           "lang_en="foo"". Re<?>ine<?>i ca acest lucru adauga automat
           atributul dat <?>i in lista attributes.

       force
           Continua chiar daca DTD-ul este necunoscut sau daca onsgmls
           gase<?>te erori in fi<?>ierul de intrare.

       include-all
           In mod implicit, msgid-urile care con<?>in o singura entitate
           (precum "&version;") sunt ignorate pentru confortul traducatorilor.
           Activarea acestei op<?>iuni impiedica aceasta optimizare. Poate fi
           utila daca documentul con<?>ine o construc<?>ie precum
           "<title>&Aacute;</title>", chiar daca ma indoiesc ca astfel de
           lucruri se vor intampla vreodata...

       ignore-inclusion
           Lista de entita<?>i separate prin spa<?>ii care nu vor fi inserate.
           Utiliza<?>i aceasta op<?>iune cu precau<?>ie: poate determina
           onsgmls (utilizat intern) sa adauge etichete <?>i sa faca
           documentul de ie<?>ire nevalid.

STAREA ACESTUI MODUL
       Rezultatul este perfect. Adica, documentele generate sunt exact la fel
       ca originalele. Dar exista inca unele probleme:

       o Ie<?>irea de eroare a onsgmls este redirec<?>ionata implicit catre
         ,,/dev/null", ceea ce este clar rau. Nu <?>tiu cum sa evit asta.

         Problema este ca trebuie sa ,,protejez" incluziunile condi<?>ionate
         (adica chestiile "<! [ %foo [" <?>i "]]>") de onsgmls. In caz
         contrar, onsgmls le mananca, iar eu nu <?>tiu cum sa le restaurez in
         documentul final. Pentru a preveni acest lucru, le rescriu in
         "{PO4A-beg-foo}" <?>i "{PO4A-end}".

         Problema este ca "{PO4A-end}" <?>i altele pe care le adaug nu sunt
         valide in document (nu intr-o eticheta <p> sau a<?>a ceva).

         Daca dori<?>i sa vizualiza<?>i rezultatul onsgmls, trebuie doar sa
         adauga<?>i urmatorul text la linia de comanda (sau la linia de
         configurare po4a):

           -o debug=onsgmls

       o Func<?>ioneaza numai cu DTD-urile DebianDoc <?>i DocBook. Adaugarea
         suportului pentru un nou DTD ar trebui sa fie foarte u<?>oara.
         Mecanismul este acela<?>i pentru fiecare DTD, trebuie doar sa
         furniza<?>i o lista a etichetelor existente <?>i unele dintre
         caracteristicile lor.

         Sunt de acord, acest lucru are nevoie de mai multa documenta<?>ie,
         dar este inca considerat beta <?>i nu-mi place sa documentez lucruri
         care se pot/vor schimba.

       o Aten<?>ie, suportul pentru DTD-uri este destul de experimental. Nu am
         citit niciun manual de referin<?>a pentru a gasi defini<?>ia fiecarei
         etichete. Am adaugat defini<?>ii de etichete la modul pana cand a
         func<?>ionat pentru unele documente pe care le-am gasit in internet.
         Daca documentul dvs. utilizeaza mai multe etichete decat al meu, nu
         va func<?>iona. Dar, a<?>a cum am spus mai sus, remedierea acestui
         lucru ar trebui sa fie destul de u<?>oara.

         Am testat DocBook doar pe SAG (,,System Administrator Guide": Ghidul
         administratorului de sistem), dar acest document este destul de mare
         <?>i ar trebui sa utilizeze majoritatea specificita<?>ilor DocBook.

         Pentru DebianDoc, am testat unele dintre manualele din DDP, dar nu
         toate inca.

       o In cazul includerii unui fi<?>ier, referin<?>a de <?>ir de caractere
         a mesajelor din fi<?>ierele PO (de exemplu, linii precum "#:
         en/titletoc.sgml:9460") va fi gre<?>ita.

         Acest lucru se datoreaza faptului ca preprocesez fi<?>ierul pentru a
         proteja includerea condi<?>ionata (de exemplu, chestiunea "<! [ %foo
         [" and "]]>") <?>i unele entita<?>i (cum ar fi "&version;") de
         onsgmls, deoarece le vreau textuale pentru documentul generat. Pentru
         aceasta, fac o copie temporara a fi<?>ierului de intrare <?>i
         efectuez toate modificarile pe care le doresc la acesta inainte de
         a-l transmite lui onsgmls pentru analizare.

         Pentru a func<?>iona, inlocuiesc entita<?>ile care solicita
         includerea unui fi<?>ier cu con<?>inutul fi<?>ierului dat (astfel
         incat sa pot proteja <?>i ceea ce trebuie sa fie intr-un
         subfi<?>ier). Dar nimic nu se face pana acum pentru a corecta
         referin<?>ele (adica numele fi<?>ierului <?>i numarul liniei) dupa
         aceea. Nu sunt sigur care este cel mai bun lucru de facut.

AUTORI
       Acest modul este o versiune adaptata a sgmlspl (postprocesor SGML
       pentru analizatorul ONSGMLS) care a avut:

        Drepturi de autor (C) 1995 David Megginson <dmeggins@aix1.uottawa.ca>

       Adaptarea pentru po4a a fost facuta de:

        Denis Barbier <barbier@linuxfr.org>
        Martin Quinson (mquinson#debian.org)

DREPTURI DE AUTOR <?>i LICEN<?>A
        Drepturi de autor (C) 1995 David Megginson <dmeggins@aix1.uottawa.ca>.
        Drepturi de autor (C) 2002-2005 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::SGML.3PM(1)