Scroll to navigation

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

NUME

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

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.

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

STAREA ACESTUI MODUL

Acest modul este într-un stadiu incipient de dezvoltare. A fost testat cu succes pe fișiere simple precum "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.

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

"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, "1.1 bar") sau o listă neordonată (de exemplu, "o baz") nu poate fi detectat(ă).

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ă 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 "|ref|".Același lucru este valabil și pentru etichetele de referință, cum ar fi "|ref|".

Utilizarea opțiunii "--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 "vim:tw=78:ts=8:noet:ft=help:norl:", așa cum se vede în "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:
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.
Valoarea implicită generică a "--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.

CONSULTAȚI ȘI

Locale::Po4a::TransTractor(3pm), po4a(7)

AUTORI

 gemmaro <gemmaro.dev@gmail.com>

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

2025-09-14 perl v5.40.1