
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NUME

po4a - actualizează atât fișierele PO, cât și documentele traduse dintr-o
singură lovitură

=head1 SINOPSIS

B<po4a> [I<opțiuni>] I<fișier-configurare>

=head1 DESCRIERE

po4a (PO pentru orice) facilitează întreținerea traducerii documentației
utilizând instrumentele clasice gettext. Principala caracteristică a po4a
este că decuplează traducerea conținutului de structura documentului. Vă
rugăm să consultați pagina L<po4a(7)> pentru o introducere ușoară în acest
proiect.

La execuție, B<po4a> analizează toate fișierele de documentație specificate
în fișierul său de configurare. Acesta actualizează fișierele PO (care
conțin traducerea) pentru a reflecta orice modificare a documentației și
produce o documentație tradusă prin injectarea traducerii conținutului
(găsit în fișierele PO) în structura documentului principal original.

La început, fișierele PO conțin doar șirurile care trebuie traduse din
documentația originală. Acest format de fișier permite traducătorilor să
furnizeze manual o traducere pentru fiecare paragraf extras de B<po4a>. Dacă
documentația este modificată după traducere, B<po4a> marchează traducerile
corespunzătoare ca „fuzzy” (traduceri aproximative) în fișierul PO pentru a
solicita o revizuire manuală de către traducători. Traducătorii pot furniza,
de asemenea, așa-numitele „addendum”, care sunt conținuturi suplimentare
care precizează, de exemplu, cine a realizat traducerea și cum se pot
raporta erorile.

 documente principale ---+---->-------->------->-------+
  (doc. redactate)       |                             |
                         V       (execuții po4a)       >-----+--> documente
                         |                             |     |     traduse
 fișiere PO existente  -->--> fişiere PO actualizate >-+     |
         ^                            |                      |
         |                            V                      |
         +----------<---------<-------+                      ^
         (procesul manual de traducere)                      |
                                                             |
 addendum -->------------------------------------------------+

Fluxul de lucru al B<po4a> este asincron, potrivit proiectelor de cod-sursă
deschis. Autorii documentației scriu documentele principale în ritmul lor
propriu. Traducătorii revizuiesc și actualizează traducerile din fișierele
PO. Responsabilii de întreținere reiau B<po4a> la nevoie, pentru a reflecta
în fișierele PO orice modificare a documentației originale și pentru a
produce traduceri actualizate ale documentației, prin injectarea celei mai
recente traduceri în cea mai recentă structură a documentului.

În mod implicit, un anumit document tradus este produs atunci când cel puțin
80% din conținutul său este tradus. Textul netradus este păstrat în limba
originală. Documentația produsă amestecă astfel limbile dacă traducerea nu
este completă. Puteți modifica pragul de 80% cu opțiunea I<--keep> descrisă
mai jos. Rețineți totuși că eliminarea traducerilor de îndată ce acestea nu
sunt 100% poate fi descurajantă pentru traducătorii a căror muncă nu va fi
aproape niciodată prezentată utilizatorilor, în timp ce prezentarea
„traducerilor” care sunt prea incomplete poate fi deranjantă pentru
utilizatorii finali.

Stocarea fișierelor documentației traduse în sistemul de control al
versiunii este probabil o idee proastă, deoarece acestea sunt generate
automat. Fișierele prețioase sunt fișierele PO, care conțin munca grea a
colegilor traducători. De asemenea, unele persoane consideră că este mai
ușor să interacționeze cu traducătorii printr-o platformă activă în
Internet, cum ar fi S<weblate>, dar acest lucru este, desigur, complet
opțional.

=head2 Tutorial de inițiere rapidă

Să presupunem că mențineți un program numit B<foo> care are o pagină de
manual F<man/foo.1> scrisă în limba engleză (limba punte în majoritatea
proiectelor de cod sursă deschis, dar B<po4a> poate fi utilizat din sau
către orice limbă). Cu ceva timp în urmă, cineva a furnizat o traducere în
limba germană numită F<man/foo.de.1> și a dispărut. Aceasta este o problemă
pentru că tocmai ați primit un raport de eroare care spune că documentația
dvs. conține o informație grav-înșelătoare care trebuie corectată în toate
limbile, dar nu vorbiți germana, deci puteți modifica doar originalul, nu și
traducerea. Acum, un alt contribuitor dorește să contribuie cu o traducere
în japoneză, o limbă pe care nici tu nu o stăpânești.

Este timpul să vă convertiți documentația în B<po4a> pentru a vă rezolva
coșmarurile legate de întreținerea documentației. Doriți să actualizați
documentația atunci când este necesar, doriți să ușurați munca colegilor
dvs. traducători și doriți să vă asigurați că utilizatorii dvs. nu văd
niciodată o documentație învechită și, prin urmare, înșelătoare.

Conversia include două etape: configurarea infrastructurii po4a și
convertirea traducerii germane anterioare pentru a salva munca
anterioară. Această ultimă parte este realizată utilizând
S<po4a-gettextize>, după cum urmează. După cum se detaliază în documentația
L<po4a-gettextize(1)>, acest proces rareori este complet automat, dar odată
realizat, fișierul B<de.po> care conține traducerea germană poate fi
integrat în fluxul de lucru po4a.

  po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po

Să configurăm acum po4a. Cu aspectul corespunzător al fișierului, fișierul
dvs. de configurare ar putea fi la fel de simplu ca acesta:

 [po_directory] man/po4a/

 [type: man] man/foo.1 $lang:man/translated/foo.$lang.1

Aceasta specifică faptul că toate fișierele PO (care conțin munca
traducătorilor) se află în directorul F<man/po4a/> și că aveți un singur
fișier principal, F<man/foo.1>. Dacă ați avea mai multe fișiere principale,
ați avea mai multe linii similare celei de-a doua. Fiecare astfel de linie
specifică, de asemenea, unde să se scrie fișierele de traducere
corespunzătoare. Aici, traducerea în limba germană a fișierului F<man/foo.1>
este în F<man/translated/foo.de.1>.

Ultimul lucru de care avem nevoie pentru a finaliza configurarea B<po4a>
este un fișier POT care conține materialul șablon care ar trebui utilizat
pentru a începe o nouă traducere. Creați pur și simplu un fișier gol cu
extensia S<.pot> în directorul S<po_directory> specificat (de exemplu,
F<man/po4a/foo.pot>), iar B<po4a> îl va umple cu conținutul așteptat.

Iată o recapitulare a fișierelor din această configurație:

  ├── man/
  │   ├── foo.1        <- Pagina de manual originală, în limba engleză
  │   ├── po4a/
  │   │   ├── de.po    <- Traducerea PO în limba germană, de la gettextizare
  │   │   └── foo.pot  <- Șablonul POT al viitoarelor traduceri (gol la început)
  │   └── translated/  <- Directorul în care vor fi create traducerile
  └── po4a.cfg         <- Fișierul de configurare

Odată configurat, execuția B<po4a> va analiza documentația, va actualiza
fișierul șablon POT, îl va utiliza pentru a actualiza fișierele de traducere
PO și le va utiliza pentru a actualiza fișierele de traducere a
documentației. Totul într-o singură comandă:

        po4a --verbose po4a.cfg

Asta este tot. B<po4a> este acum complet configurat. După ce ați corectat
eroarea din F<man/foo.1>, paragraful incorect din traducerea în germană va
fi înlocuit cu textul corectat în engleză. Amestecarea limbilor nu este
optimă, dar este singura modalitate de a elimina erorile din traduceri pe
care nici măcar nu le înțelegeți și de a vă asigura că conținutul prezentat
utilizatorilor nu este niciodată înșelător. Actualizarea traducerii în limba
germană este, de asemenea, mult mai ușoară în fișierul PO corespunzător,
astfel încât amestecul de limbi poate să nu dureze mult. În cele din urmă,
atunci când un traducător japonez dorește să contribuie cu o nouă traducere,
ar trebui să redenumească fișierul S<foo.pot> în S<ja.po> și să completeze
traducerea. Odată ce aveți acest fișier, introduceți-l în F<man/po4a/po/>. O
pagină tradusă va apărea ca F<man/translated/foo.ja.1> (cu condiția ca o
cantitate suficientă de conținut să fie tradusă) atunci când executați din
nou B<po4a>.

=head1 OPȚIUNI

=over 4

=item B<-k>, B<--keep>

Pragul minim pentru procentul de traducere pentru a păstra (adică a scrie)
fișierul rezultat (implicit: 80). Adică, în mod implicit, fișierele trebuie
să fie traduse la cel puțin 80% pentru a fi scrise pe disc.

=item B<-w>, B<--width>

Coloana la care ar trebui să încadrăm fișierul rezultat dacă formatul
acceptă acest lucru (implicit: 76). Dacă valoarea furnizată este 0 sau
negativă, atunci fișierul rezultat nu va fi încadrat deloc. Acest lucru este
util în cazul anumitor formate care s-ar putea rupe atunci când sunt
re-încadrate.

=item B<-h>, B<--help>

Afișează un scurt mesaj de ajutor.

=item B<-M>, B<--master-charset>

Setul de caractere al fișierelor care conțin documentele de tradus. Rețineți
că toate documentele principale trebuie să utilizeze același set de
caractere.

=item B<-L>, B<--localized-charset>

Setul de caractere al fișierelor care conțin documentele de tradus. Rețineți
că toate documentele traduse vor utiliza același set de caractere.

=item B<-A>, B<--addendum-charset>

Setul de caractere al addendei. Rețineți că toate addendele trebuie să fie
în același set de caractere.

=item B<-V>, B<--version>

Afișează versiunea scriptului și iese.

=item B<-v>, B<--verbose>

Crește nivelul de detaliere al programului.

=item B<-q>, B<--quiet>

Reduce nivelul de detaliere al programului.

=item B<-d>, B<--debug>

Afișează unele informații de depanare.

=item B<-o>, B<--option>

Opțiuni suplimentare pe care să le transmiteți modulului de
format. Consultați documentația fiecărui modul pentru mai multe informații
despre opțiunile valide și semnificațiile acestora. De exemplu, ați putea
transmite „-o tablecells” analizatorului AsciiDoc, în timp ce analizatorul
de text ar accepta „-o tabs=split”.

=item B<-f>, B<--force>

Generează întotdeauna fișierele POT și PO, chiar dacă B<po4a> consideră că
nu este necesar.

Comportamentul implicit (atunci când opțiunea B<--force> nu este
specificată) este următorul:

=over

În cazul în care fișierul POT există deja, acesta este regenerat dacă un
document principal sau fișierul de configurare este mai recent (cu excepția
cazului în care se furnizează B<--no-update>). De asemenea, fișierul POT
este scris într-un document temporar, iar B<po4a> verifică dacă modificările
sunt într-adevăr necesare.

De asemenea, o traducere este regenerată numai dacă documentul său
principal, fișierul PO, unul dintre addenda sau fișierul de configurare este
mai recent. Pentru a evita încercarea de regenerare a traducerilor care nu
trec testul pragului (a se vedea B<--keep>), poate fi creat un fișier cu
extensia F<.po4a-stamp> (a se vedea B<--stamp>).

=back

Dacă un document principal include fișiere, trebuie să utilizați marcajul
B<--force> deoarece timpul de modificare al acestor fișiere incluse nu este
luat în considerare.

Fișierele PO sunt întotdeauna re-generate pe baza POT cu B<msgmerge -U>.

=item B<--stamp>

Îi indică lui B<po4a> să creeze fișiere ștampilă (marcă-de-timp) atunci când
o traducere nu este generată deoarece nu atinge pragul. Aceste fișiere
ștampilă sunt denumite în funcție de documentul tradus așteptat, cu extensia
F<.po4a-stamp>.

Notă: Aceasta activează doar crearea fișierelor F<.po4a-stamp>. Fișierele
ștampilă sunt întotdeauna utilizate dacă există și sunt eliminate cu
B<--rm-translations> sau atunci când fișierul este tradus definitiv.

=item B<--no-translations>

Nu generează documentele traduse, ci doar actualizează fișierele POT și PO.

=item B<--no-update>

Nu modifică fișierele POT și PO, doar traducerea poate fi actualizată.

=item B<--keep-translations>

Păstrează fișierele de traducere existente chiar dacă traducerea nu atinge
pragul specificat de B<--keep>. Această opțiune nu creează noi fișiere de
traducere cu conținut redus, dar va salva traducerile existente care se
degradează din cauza modificărilor aduse fișierelor principale.

AVERTISMENT: Această opțiune schimbă comportamentul po4a într-un mod destul
de drastic: fișierele dvs. traduse nu vor fi actualizate deloc până când
traducerea nu se îmbunătățește. Utilizați această opțiune numai dacă
preferați să trimiteți o documentație tradusă învechită în loc să trimiteți
o documentație netradusă corectă.

=item B<--rm-translations>

Elimină fișierele traduse (implică B<--no-translations>).

=item B<--no-backups>

Această opțiune nu are niciun efect de la versiunea 0.41 și poate fi
eliminată în versiunile ulterioare.

=item B<--rm-backups>

Această opțiune nu are niciun efect de la versiunea 0.41 și poate fi
eliminată în versiunile ulterioare.

=item B<--translate-only> I<fișier-traducere>

Traduce numai fișierul specificat. Aceasta poate fi utilă pentru a accelera
procesarea dacă un fișier de configurare conține multe fișiere. Rețineți că
această opțiune nu actualizează fișierele PO și POT. Această opțiune poate
fi utilizată de mai multe ori.

=item B<--variable> I<variabilă>B<=>I<valoare>

Definește o variabilă care va fi extinsă în fișierul de configurare
B<po4a>. Fiecare apariție a lui I<$(var)> va fi înlocuită cu
I<valoare>. Această opțiune poate fi utilizată de mai multe ori.

=item B<--target-lang> I<LIMBA>

Actualizează fișierele PO și generează documente traduse numai pentru limba
specificată. Această opțiune poate fi utilizată de mai multe ori.

=item B<--srcdir> I<DIR_SURSĂ>

Definește directorul de bază pentru toate documentele de intrare specificate
în fișierul de configurare B<po4a>.

Dacă sunt specificate atât I<DIR_DESTINAȚIE>, cât și I<DIR_SURSĂ>, fișierele
de intrare sunt căutate în următoarele directoare, în ordine:
I<DIR_DESTINAȚIE>, directorul curent și I<DIR_SURSĂ>. Fișierele de ieșire
sunt scrise în I<DIR_DESTINAȚIE>, dacă este specificat, sau în directorul
curent.

=item B<--destdir> I<DIR_DESTINAȚIE>

Definește directorul de bază pentru toate documentele de ieșire specificate
în fișierul de configurare B<po4a> (a se vedea opțiunea B<--srcdir> de mai
sus).

=back

=head2 Opțiuni ce modifică antetul POT

=over 4

=item B<--porefs> I<tip>

Specifică formatul referinței. Argumentul I<tip> poate fi unul dintre
B<never> pentru a nu produce nicio referință, B<file> pentru a specifica
doar fișierul fără numărul de linie, B<counter> pentru a înlocui numărul de
linie cu un contor crescător și B<full> pentru a include referințe complete
(implicit: full).

=item B<--wrap-po> B<no>|B<newlines>|I<număr> (implicit: 76)

Specifică modul în care liniile din fișierul po ar trebui să fie
încadrate. Acest lucru oferă posibilitatea de a alege între fișiere care
sunt bine ajustate ca încadrare, dar ar putea duce la conflicte git, sau
fișiere care sunt mai ușor de gestionat automat, dar mai greu de citit
pentru oameni.

Din punct de vedere istoric, suita gettext a reformatat fișierele po la a
77-a coloană pentru cosmetică. Această opțiune specifică comportamentul lui
po4a. Dacă este definită la o valoare numerică, po4a va împacheta fișierul
po după această coloană și după noile linii din conținut. Dacă este definită
la B<newlines>, po4a va împărți doar msgid și msgstr după linii noi din
conținut. Dacă este definită la B<no>, po4a nu va încadra deloc fișierul
po. Comentariile de referință sunt întotdeauna încadrate de instrumentele
gettext pe care le folosim intern.

Rețineți că această opțiune nu are niciun impact asupra modului în care
msgid și msgstr sunt încadrate, adică asupra modului în care sunt adăugate
linii noi la conținutul acestor șiruri.

=item B<--master-language>

Limba fișierelor sursă care conțin documentele de tradus. Rețineți că toate
documentele principale trebuie să utilizeze aceeași limbă.

=item B<--msgid-bugs-address> I<adresă@poștă.electronică>

Definește adresa de raportare pentru erori din msgid. În mod implicit,
fișierele POT create nu au câmpuri Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<șir>

Definește deținătorul drepturilor de autor în antetul POT. Valoarea
implicită este „Free Software Foundation, Inc.”

=item B<--package-name> I<șir>

Definește numele pachetului pentru antetul POT. Valoarea implicită este
„PACKAGE”.

=item B<--package-version> I<șir>

Definește versiunea pachetului pentru antetul POT. Valoarea implicită este
„VERSION”.

=back

=head2 Opțiuni pentru modificarea fișierelor PO

=over 4

=item B<--msgmerge-opt> I<opțiuni>

Opțiuni suplimentare pentru B<msgmerge>(1).

Notă: B<$lang> va fi extins la limba curentă.

=item B<--no-previous>

Această opțiune elimină B<--previous> din opțiunile transmise către
B<msgmerge>. Acest lucru este necesar pentru a oferi suport versiunilor de
B<gettext> anterioare versiunii 0.16.

=item B<--previous>

Această opțiune adaugă B<--previous> la opțiunile transmise către
B<msgmerge>. Aceasta necesită B<gettext> 0.16 sau o versiune ulterioară și
este activată implicit.

=back

=head1 FIȘIERUL DE CONFIGURARE

po4a așteaptă ca argument un fișier de configurare. Acest fișier trebuie să
conțină următoarele elemente:

=over

=item

Ruta către fișierele PO și lista de limbi existente în proiect;

=item

Opțional, unele opțiuni globale și așa-numitele alias de configurare care
sunt utilizate ca șabloane pentru a configura fișiere principale individual;

=item

Lista fiecărui fișier principal de tradus, împreună cu parametrii specifici.

=back

Toate liniile conțin o comandă între paranteze drepte, urmată de parametrii
acesteia. Comentariile încep cu caracterele „#” și continuă până la
sfârșitul liniei. Puteți eluda sfârșitul liniei pentru a întinde o comandă
pe mai multe linii.

Unele exemple complete sunt prezentate pe această pagină, în timp ce alte
exemple pot fi găsite în directorul C<t/cfg> al distribuției sursă.

=head2 Găsirea fișierelor PO și POT

Cea mai simplă soluție este de a indica în mod explicit ruta către fișierele
POT și PO, după cum urmează:

 [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po

Aceasta specifică mai întâi ruta către fișierul POT și apoi rutele către
fișierele PO în limbile germană și franceză.

Aceleași informații pot fi scrise după cum urmează pentru a reduce riscul de
erori de copiere/lipire:

 [po4a_langs] fr de
 [po4a_paths] man/po/project.pot $lang:man/po/$lang.po

Componenta C<$lang> este extinsă automat folosind lista de limbi furnizată,
reducând riscul de erori de copiere/lipire atunci când este adăugată o limbă
nouă.

Puteți compacta în continuare aceleași informații furnizând doar ruta către
directorul care conține proiectul dvs. de traducere, după cum urmează.

 [po_directory] man/po/

Directorul furnizat trebuie să conțină un set de fișiere PO, fiecare denumit
F<XX.po>, C<XX> fiind codul ISO 639-1 al limbii utilizate în acest
fișier. Directorul trebuie să conțină, de asemenea, un singur fișier POT, cu
extensia de fișier C<.pot>. Pentru prima rulare, acest fișier poate fi gol,
dar trebuie să existe (po4a nu poate ghici numele de utilizat înainte de
extensie).

Rețineți că trebuie să alegeți doar una dintre variantele C<po_directory> și
C<po4a_paths>. Prima (C<po_directory>) este mai compactă, reduce și mai mult
riscul erorilor de copiere/lipire, dar vă obligă să utilizați structura de
proiect și numele de fișiere așteptate. A doua (C<po4a_paths>), este mai
explicită, probabil mai ușor de citit și este recomandată atunci când
configurați primul proiect cu po4a.

=head3 Fișiere PO centralizate sau divizate?

În mod implicit, po4a produce un singur fișier PO pentru fiecare limbă
țintă, conținând întregul conținut al proiectului dvs. de traducere. Pe
măsură ce proiectul dumneavoastră crește, dimensiunea acestor fișiere poate
deveni problematică. Atunci când utilizați weblate, este posibil să
specificați priorități pentru fiecare segment de traducere (de exemplu,
msgid), astfel încât cele importante să fie traduse primele. Totuși, unele
echipe de traducători preferă să împartă conținutul în mai multe fișiere.

Pentru a avea un fișier PO pentru fiecare fișier principal, trebuie doar să
utilizați șirul C<$master> în numele fișierelor PO de pe linia
C<[po4a_paths]>, după cum urmează.

 [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

Cu această linie, po4a va produce fișiere POT și PO separate pentru fiecare
document de tradus. De exemplu, dacă aveți 3 documente și 5 limbi, aceasta
va avea ca rezultat 3 fișiere POT și 15 fișiere PO. Aceste fișiere sunt
denumite după cum se specifică în șablonul C<po4a_paths>, cu C<$master>
înlocuit cu numele de bază al fiecărui document de tradus. În caz de
conflict de nume, puteți specifica fișierul POT de utilizat după cum
urmează, cu parametrul C<pot=>.

Această caracteristică poate fi utilizată și pentru a grupa mai multe
fișiere traduse în același fișier POT. Următorul exemplu produce doar 2
fișiere POT: F<l10n/po/foo.pot> (conținând materialul din F<foo/gui.xml>) și
F<l10n/po/bar.pot> (conținând materialul din F<bar/gui.xml> și
F<bar/cli.xml>).

 [po4a_langs] de fr ja
 [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
 [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo
 [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar
 [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar

În modul divizare, B<po4a> construiește un compendiu temporar în timpul
actualizării PO, pentru a partaja traducerile între toate fișierele PO. În
cazul în care două fișiere PO au traduceri diferite pentru același șir de
caractere, B<po4a> va marca acest șir ca fiind fuzzy și va prezenta ambele
traduceri în toate fișierele PO care conțin acest șir de caractere. În cazul
în care traductorul a eliminat fuzzy-ul, traducerea este utilizată automat
în toate fișierele PO.

=head2 Specificarea documentelor de tradus

De asemenea, trebuie să listați documentele care trebuie traduse. Pentru
fiecare fișier principal, trebuie să specificați analizatorul de format care
urmează să fie utilizat, locația documentului tradus care urmează să fie
produs și, opțional, o anumită configurare. Numele fișierelor trebuie să fie
puse între ghilimele sau eludate dacă conțin spații. Iată un exemplu:

 [type: sgml] "doc/my stuff.sgml"  "fr:doc/fr/mon truc.sgml"  de:doc/de/mein\ kram.sgml
 [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
 [type: docbook] doc/script.xml fr:doc/fr/script.xml \
             de:doc/de/script.xml

Dar, din nou, aceste linii complexe sunt dificil de citit și de modificat,
de exemplu atunci când se adaugă un nou limbaj. Este mult mai simplu să
reorganizați lucrurile folosind șablonul C<$lang> după cum urmează:

 [type: sgml]    doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml
 [type: man]     script.1          $lang:po/$lang/script.1
 [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml

=head2 Specificarea opțiunilor

Există două tipuri de opțiuni: I<opțiuni po4a> sunt valorile implicite ale
opțiunilor din linia de comandă po4a, în timp ce I<opțiuni format> sunt
utilizate pentru a modifica comportamentul analizatorilor de format. Ca
I<opțiuni po4a>, ați putea, de exemplu, să specificați în fișierul dvs. de
configurare că valoarea implicită a parametrului de linie de comandă
B<--keep> este 50% în loc de 80%. I<Opțiunile de format> sunt documentate pe
pagina specifică a fiecărui modul de analizare, de exemplu
L<Locale::Po4a::Xml(3pm)>. Ați putea, de exemplu, să treceți B<nostrip>
analizorului XML pentru a nu elimina spațiile din jurul șirurilor extrase.

Puteți trece aceste opțiuni pentru un anumit fișier principal sau chiar
pentru o anumită traducere a fișierului respectiv, utilizând C<opt:> și
C<opt_XX:> pentru limba C<XX>. În exemplul următor, opțiunea B<nostrip> este
transmisă analizatorului XML (pentru toate limbile), în timp ce pragul va fi
redus la 0% pentru traducerea în franceză (care este astfel păstrată
întotdeauna).

 [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"

În orice caz, aceste bucăți de configurare trebuie să fie situate la
sfârșitul liniei. Declarația fișierelor trebuie să fie prima, apoi
addendumul, dacă există (a se vedea mai jos), și apoi doar
opțiunile. Gruparea bucăților de configurare nu este foarte importantă,
deoarece elementele sunt concatenate intern ca șiruri de
caractere. Exemplele următoare sunt toate echivalente:

  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0

Rețineți că opțiunile specifice fiecărei limbi nu sunt utilizate la crearea
fișierului POT. De exemplu, este imposibil să transmiteți B<nostrip>
analizatorului doar atunci când creați traducerea în franceză, deoarece
același fișier POT este utilizat pentru actualizarea fiecărei limbi. Prin
urmare, singurele opțiuni care pot fi specifice unei limbi sunt cele care
sunt utilizate la realizarea traducerii, cum ar fi opțiunea C<--keep>.

=head3 Alias de configurare

Pentru a transmite aceleași opțiuni mai multor fișiere, cel mai bine este să
definiți un alias de tip după cum urmează. În exemplul următor, C<--keep 0>
este transmis la fiecare traducere italiană folosind acest tip C<test>,
adică o extensie a tipului C<man>.

  [po4a_alias:test] man opt_it:"--keep 0"
  [type: test] man/page.1 $lang:man/$lang/page.1

De asemenea, puteți extinde un tip existent reutilizând același nume pentru
alias, după cum urmează. Aceasta nu este interpretată ca o definiție
recursivă eronată.

  [po4a_alias:man] man opt_it:"--keep 0"
  [type: man] man/page.1 $lang:man/$lang/page.1

=head3 Opțiuni implicite globale

De asemenea, puteți utiliza liniile C<[options]> pentru a defini opțiuni
care trebuie utilizate pentru toate fișierele, indiferent de tipul acestora.

  [options] --keep 20 --option nostrip

Ca și în cazul opțiunilor din linia de comandă, puteți abrevia parametrii
trecuți în fișierul de configurare:

  [options] -k 20 -o nostrip

=head3 Prioritatea opțiunilor

Opțiunile fiecărei surse sunt concatenate, asigurându-se că valorile
implicite pot fi ușor anulate prin opțiuni mai specifice. Ordinea este
următoarea:

=over

=item

Liniile C<[options]> furnizează valori implicite care pot fi anulate de
orice altă sursă.

=item

Se utilizează apoi alias de tip. Opțiuniile specifice limbii prevalează
asupra celor aplicabile tuturor limbilor.

=item

Opțiunile specifice unui anumit fișier principal prevalează atât asupra
celor implicite, cât și asupra celor care provin din pseudonimul de tip. De
asemenea, în acest caz, opțiunile specifice limbii prevalează asupra celor
globale.

=item

În cele din urmă, parametrii furnizați în linia de comandă B<po4a>
prevalează asupra oricăror opțiuni din fișierul de configurare.

=back

=head3 Exemplu

Iată un exemplu care arată cum să citați spațiile și ghilimelele:

 [po_directory] man/po/
 
 [options] --master-charset UTF-8
 
 [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
 [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
            opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose

=head2 Addendum: Adăugarea de conținut suplimentar în traducere

Dacă doriți să adăugați o secțiune suplimentară la traducere, de exemplu
pentru a acorda mulțumiri traducătorului, atunci trebuie să definiți un
addendum la linia care definește fișierul principal. Vă rugăm să consultați
pagina L<po4a(7)> pentru mai multe detalii privind sintaxa fișierelor
addendum.

 [type: pod] script fr:doc/fr/script.1 \
             add_fr:doc/l10n/script.fr.add

De asemenea, puteți utiliza șabloane de limbă după cum urmează:

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.add

Dacă un addendum eșuează la aplicare, traducerea este respinsă.

=head3 Modificatori pentru declarația de addendum

Modificatorii de addendum pot simplifica fișierul de configurare în cazul în
care nu toate limbile furnizează un addendum sau atunci când lista de
addendumuri se modifică de la o limbă la alta. Modificatorul este un singur
caracter situat înaintea numelui fișierului.

=over 2

=item B<?>

Include I<ruta_la_addendum> dacă acest fișier există, altfel nu face nimic.

=item B<@>

I<ruta_la_addendum> nu este un addendum obișnuit, ci un fișier care conține
o listă de addenda, rând pe rând. Fiecare addendum poate fi precedat de
modificatori.

=item B<!>

I<ruta_la_addendum> (fișierul către care arată) este înlăturat, nu este
încărcat și nu va fi încărcat de nicio altă specificație de addendum.

=back

Următoarele includ un addendum în orice limbă, dar numai dacă acesta
există. Nu este raportată nicio eroare dacă addendumul nu există.

 [type: pod] script $lang:doc/$lang/script.1  add_$lang:?doc/l10n/script.$lang.add

Următoarele includ o listă de addendumuri pentru fiecare limbă:

 [type: pod] script $lang:doc/$lang/script.1  add_$lang:@doc/l10n/script.$lang.add

=head2 Filtrarea șirurilor traduse

Uneori, doriți să ascundeți anumite șiruri de caractere de procesul de
traducere. În acest scop, puteți oferi un parametru C<pot_in> fișierului
principal pentru a specifica numele fișierului care urmează să fie utilizat
în locul fișierului principal real la construirea fișierului POT. Iată un
exemplu:

  [type:docbook] book.xml          \
          pot_in:book-filtered.xml \
          $lang:book.$lang.xml

Cu această configurare, șirurile de caractere de tradus vor fi extrase din
F<book-filtered.xml> (care trebuie produs înainte de a apela B<po4a>), în
timp ce fișierele traduse vor fi construite din F<book.xml>. Ca urmare,
orice șir care face parte din F<book.xml>, dar nu din F<book-filtered.xml>
nu va fi inclus în fișierele PO, împiedicând traducătorii să furnizeze o
traducere pentru acestea. Astfel, aceste șiruri de caractere vor rămâne
nemodificate la producerea documentelor traduse. Acest lucru scade în mod
natural nivelul de traducere, astfel încât este posibil să aveți nevoie de
opțiunea C<--keep> pentru a vă asigura că documentul este produs oricum.

=head1 CONSULTAȚI ȘI

L<po4a-gettextize(1)>, L<po4a(7)>.

=head1 AUTORI

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)

=head1 DREPTURI DE AUTOR și LICENȚĂ

Drepturi de autor 2002-2023 pentru SPI, inc.

Acest program este software liber; îl puteți redistribui și/sau modifica în
conformitate cu termenii GPL v2.0 sau o versiune ulterioară (consultați
fișierul COPYING).
