
        *****************************************************
        *           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

Locale::Po4a::VimHelp - convertește fișiere de ajutor Vim din/în fișiere PO.

=head1 DESCRIERE

Scopul proiectului po4a (PO pentru orice) este de a ușura traducerile (și
mai interesant, întreținerea traducerilor) folosind instrumente gettext în
domenii în care nu erau așteptate, cum ar fi documentația.

C<Locale::Po4a::VimHelp> este un modul de ajutor pentru traducerea
fișierelor de ajutor Vim. Consultați și L<Writing help files (scrierea
fișierelor de ajutor)|https://vimhelp.org/helphelp.txt.html#help-writing>
pentru sintaxa acestuia.

=head1 STAREA ACESTUI MODUL

Acest modul este într-un stadiu incipient de dezvoltare. A fost testat cu
succes pe fișiere simple precum C<helphelp.txt>. Cu toate acestea, nu a fost
încă testat pe fișiere de ajutor complete, iar modul în care le analizează
se poate schimba în funcție de corecții și îmbunătățiri, în special în ceea
ce privește încadrarea paragrafelor.

=head1 DEZVOLTARE

Analizarea fișierelor de ajutor Vim pentru po4a este dificilă. Iată câteva
obstacole în timpul dezvoltării acestui modul. Dacă aveți o idee mai bună,
nu ezitați să sugerați „un plasture”, o corecție (cu cazuri de testare
suplimentare).

=over

=item C<1. foo> sună ca o listă ordonată

Nu neapărat. Luați în considerare următorul paragraf.

 Sunt 2 tanuki (câine enot) rătăcitori, nu
1. Își folosește tehnica de clonare.

Din același motiv, ceea ce pare a fi un titlu (de exemplu, C<1.1 bar>) sau o
listă neordonată (de exemplu, C<o baz>) nu poate fi detectat(ă).

=item Conținutul din dreapta al etichetelor ar trebui să fie exclus din traducerea
țintă

Acest subiect este, de asemenea, dificil, deoarece se referă la diferențele
dintre limbile de traducere.

Luați în considerare exemplul următor.

 Un concept atât de comun și de scurt în unele limbi *tags*

care ar putea fi tradus în

 Acestea sunt necunoscute, nu există concepte și *tags* corespunzătoare
 este nevoie de o frază mai lungă pentru a le exprima în această limbă

Când se întâmplă acest lucru, trebuie să decideți în ce moment doriți să
adăugați o etichetă I<drăguță>. Acest lucru nu este deloc ușor. Fișierul de
ajutor Vim este într-un format greu de împachetat chiar și pentru părțile
care nu sunt blocuri de cod.

Același lucru este valabil și pentru etichetele de referință, cum ar fi
C<|ref|>.Același lucru este valabil și pentru etichetele de referință, cum
ar fi C<|ref|>.

=item Se utilizează C<--wrapcol> pentru a monitoriza lățimea textului

Utilizarea opțiunii C<--wrapcol> pentru a emite avertismente atunci când
lățimea textului depășește limitele specificate pare a fi o abordare
rezonabilă. Fișierele oficiale de ajutor Vim prezintă o linie de mod, cum ar
fi C<vim:tw=78:ts=8:noet:ft=help:norl:>, așa cum se vede în
L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>.
Cu toate acestea, există câteva provocări de luat în considerare:

=over

=item Comportamentul de analizare a fișierului

Dacă această opțiune este implementată, ar fi ideal să citim mai întâi
întregul fișier, să detectăm dacă linia de mod există și să determinăm ce
secțiuni sunt afectate. Din păcate, mecanismul de analiză progresivă nu este
utilizat în acest caz.

=item Valori implicite vs. valori personalizate

Valoarea implicită generică a C<--wrapcol> este 76, în timp ce fișierele de
ajutor Vim utilizează de obicei 78.  În majoritatea cazurilor, valoarea din
opțiunile transmise acestui modul este implicit 76, dar nu este clar dacă
această valoare a fost stabilită explicit sau aplicată implicit.

=back

=back

=head1 CONSULTAȚI ȘI

L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTORI

 gemmaro <gemmaro.dev@gmail.com>

=head1 DREPTURI DE AUTOR și LICENȚĂ

 Drepturi de autor © 2024, 2025 gemmaro.

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 F<COPYING>).
