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


       1;

       __END__

NUME
       Locale::Po4a::SimplePod - converte<?>te datele POD din/in fi<?>iere PO,
       cu Pod::Simple

SINOPSIS
         [po4a_paths] /ruta/tla/pot $lang:/path/to/po
         [type:SimplePod] /ruta/la/sursa.pod $lang:/ruta/la/traducerea_in_limba_dorita.pod

       sau

         [po4a_paths] /ruta/la/pot $lang:/ruta.la/po
         [po4a_alias:pod] SimplePod
         [type:pod] /ruta/la/sursa.pod $lang:/ruta/la/traducerea_in_limba_dorita.pod

DESCRIERE
       Acesta este un modul care ajuta la traducerea documenta<?>iei in format
       POD (limbajul preferat pentru documentarea Perl) in alte limbi umane.

       Principalele diferen<?>e dintre formatul Pod actual <?>i formatul
       SimplePod sunt urmatoarele:

       o   Formatul SimplePod nu include niciodata linii noi suplimentare in
           mesajele care urmeaza sa fie traduse.  Cu toate acestea, formatul
           Pod actual poate con<?>ine linii noi suplimentare, in special in
           intrarile de mesaje ,,verbatim".

       o   Paragrafele pot fi redate cu incadrare in linie. Modulul
           Pod::Parser ar putea aplica un tratament special pentru incadrarea
           liniilor, ceea ce face dificila replicarea cu Pod::Simple. Cu toate
           acestea, Pod::Simple pare sa produca o ie<?>ire mai naturala.

       o   In SimplePod, mesajul "=for" (de exemplu, "=for comment text") nu
           include un nume de format (cum ar fi "comment"), astfel incat
           mesajul consta exclusiv din text.  In schimb, formatul Pod curent
           pastreaza numele formatului, rezultand un mesaj precum "comment
           text".  Primul comportament este considerat mai confortabil pentru
           traducatori.

       o   Intrari precum cea de mai jos, care denota "=end comment", nu mai
           sunt prezente in modulul Pod actual.  Deoarece acestea nu sunt
           mesaje traductibile, absen<?>a lor este o imbunata<?>ire.

             #. type: =end
             #: sample.pod:10
             msgid "comment"
             msgstr ""

       o   Blocurile de text a caror valabilitate a formatului POD este
           incerta sunt acum tratate ca "no-wrap". Acest lucru se aplica, de
           exemplu, con<?>inutului din cadrul unui bloc "=begin html". In
           modulul Pod, acestea nu erau tratate ca "no-wrap", ceea ce ducea
           uneori la incadrarea liniilor.

       o   Sec<?>iunea parametrului "=begin" nu mai este supusa traducerii. In
           modulul Pod actual, aceasta este inclusa. Daca exista o cerere de
           includere a acesteia in traducere, va rugam sa o raporta<?>i.

STAREA ACESTUI MODUL
       Acest modul este inca nou dezvoltat, deci este mai pu<?>in stabil decat
       Locale::Po4a::Pod. Acesta continua sa evolueze <?>i exista loc pentru
       rafinare suplimentara. Comportamentul sau se poate schimba in timp <?>i
       pot fi introduse op<?>iuni suplimentare pentru a optimiza mai bine
       experien<?>a de traducere pentru utilizatori. Opiniile, sugestiile
       <?>i cazurile de utilizare din aplica<?>iile din lumea reala vor juca
       un rol esen<?>ial in ghidarea dezvoltarii sale viitoare.

       Codul este complet acoperit de suita noastra de teste <?>i nu avem
       cuno<?>tin<?>a de nicio eroare existenta. Cu toate acestea, pana in
       2025, nu a fost testat de proiecte externe in fluxuri de traducere
       reale. Acestea fiind spuse, credem ca modulul este pregatit pentru
       utilizare in produc<?>ie, chiar daca, in mod inevitabil, vor fi
       descoperite unele erori pe masura ce va fi adoptat pe scara mai larga.

       Acest modul este destinat sa inlocuiasca modulul actual
       Locale::Po4a::Pod. Motivul este ca Pod::Parser, care este utilizat de
       actualul Locale::Po4a::Pod, este acum depreciat <?>i se recomanda
       utilizarea in schimb a Pod::Simple. Consulta<?>i <?>i GitHub issue #256
       "Consider migrating away from deprecated "Pod::Parser""
       <https://github.com/mquinson/po4a/issues/256>.

CONSULTA<?>I <?>I
       Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7),
       Locale::Po4a::SimplePod::Parser.

AUTORI
         gemmaro <gemmaro.dev@gmail.com>

DREPTURI DE AUTOR <?>i LICEN<?>A
         Drepturi de autor (C) 2024 gemmaro <gemmaro.dev@gmail.com>.

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