Încadrarea textului¶

Paragrafele neindentate sunt în mod automat re-încadrate pentru traducător. Acest lucru poate duce la unele diferențe minore în rezultatul generat, deoarece regulile de reformulare utilizate de groff nu sunt foarte clare. De exemplu, două spații după o paranteză sunt uneori păstrate.

Oricum, diferența va fi doar în ceea ce privește poziția spațiilor suplimentare în paragraful încadrat, și cred că merită.

Specificarea fontului¶

Prima modificare se referă la specificațiile de schimbare a fontului. În nroff, există mai multe modalități de a specifica dacă un anumit cuvânt ar trebui să fie scris cu litere mici, aldine sau cursive. În textul de tradus, există o singură modalitate, împrumutată din formatul POD (documentația în linie Perl):

I<text> -- text cursiv

echivalent cu \fItext\fP sau ".I text"

B<text> -- text aldin

echivalent cu \fBtext\fP sau ".B text"

R<text> -- text normal (roman)

echivalent cu \fRtext\fP

CW<text> -- text cu lățime constantă

echivalent cu \f(CWtext\fP sau ".CW text"

Observație: Aspectul CW al fontului nu este disponibil pentru toate dispozitivele Groff. Nu este recomandată utilizarea acestuia. Acesta este furnizat pentru confortul dumneavoastră.

Transliterarea automată a caracterelor¶

Po4a translitera automat unele caractere pentru a facilita traducerea sau revizuirea traducerii. Aici este lista transliterărilor:

cratime

Cratimele (-) și semnele minus (\-) din paginile de manual sunt toate transliterate ca liniuțe simple (-) în fișierul PO. Apoi, toate liniuțele sunt transliterate în semne minus roff (\-) atunci când traducerea este inserată în documentul de ieșire.

Traducătorii pot forța o cratimă prin utilizarea glifului roff „\[hy]” în traducerile lor.

spații rigide

Traducătorii pot utiliza spații fără pauză în traducerile lor. Aceste spații rigide (0xA0 în latin1) vor fi transliterate într-un spațiu fără pauză roff ('\ ').

transliterații de ghilimele

Ghilimelele `` și '' sunt transliterate în \*(lq și respectiv \*(rq.

Pentru a evita aceste transliterări, traducătorii pot introduce un caracter roff de lățime zero (de exemplu, folosind „\&” sau, respectiv, „\&”).

Introducerea „<” și „>” în traduceri¶

Deoarece aceste caractere sunt utilizate pentru a delimita părțile în care se modifică fontul, nu le puteți utiliza textual. Utilizați în schimb E<lt> și E<gt> (ca în POD, încă o dată).

Nu programați în nroff¶

nroff este un limbaj de programare complet, cu definiție macro, condiționale și așa mai departe. Deoarece acest analizator nu este un interpret nroff complet, el va eșua pe paginile care utilizează aceste facilități (există aproximativ 200 de astfel de pagini pe calculatorul meu).

Utilizați un set de macrocomenzi simplu¶

Există încă unele macrocomenzi care nu sunt acceptate de po4a::man. Acest lucru se datorează doar faptului că nu am reușit să găsesc nicio documentație despre acestea. Iată lista macrocomenzilor neacceptate utilizate pe calculatorul meu. Rețineți că această listă nu este exhaustivă, deoarece programul eșuează la prima macrocomandă neacceptată întâlnită. Dacă aveți informații despre unele dintre aceste macrocomenzi, voi adăuga cu plăcere suport pentru acestea. Din cauza acestor macrocomenzi, aproximativ 250 de pagini din calculatorul meu sunt inaccesibile pentru po4a::man.

 ..               ."              .AT             .b              .bank
 .BE              ..br            .Bu             .BUGS           .BY
 .ce              .dbmmanage      .do                             .En
 .EP              .EX             .Fi             .hw             .i
 .Id              .l              .LO             .mf
 .N               .na             .NF             .nh             .nl
 .Nm              .ns             .NXR            .OPTIONS        .PB
 .pp              .PR             .PRE            .PU             .REq
 .RH              .rn             .S<             .sh             .SI
 .splitfont       .Sx             .T              .TF             .The
 .TT              .UC             .ul             .Vb             .zZ

Ascunderea textului de po4a¶

Uneori, autorul știe că unele părți nu sunt traductibile și nu ar trebui extrase de po4a. De exemplu, o opțiune poate accepta un argument other, iar other poate apărea și ca ultimul element al unei liste. În primul caz, other nu ar trebui să poată fi tradus. Iar în al doilea caz, other ar trebui să fie tradus.

În acest caz, autorul poate evita po4a pentru a extrage unele șiruri de caractere, folosind unele construcții groff speciale:

 .if !'po4a'hide' .B other

(aceasta va necesita opțiunea -o groff_code=verbatim)

De asemenea, poate fi definit o nouă macrocomandă pentru a automatiza acest lucru:
.de IR_untranslated
. IR \\$@
..

 .IR_untranslated \-q ", " \-\-quiet

(aceasta va necesita opțiunile -o groff_code=verbatim și -o untranslated=IR_untranslated; cu această construcție, condiționalul .if !'po4a'hide' nu este strict necesar deoarece po4a nu va analiza interiorul definiției macro)

sau folosind un alias:
.als IR_untranslated IR

 .IR_untranslated \-q ", " \-\-quiet

Acesta va necesita opțiunea -o untranslated=als,IR_untranslated.

Concluzie¶

Pentru a rezuma această secțiune, păstrați simplitatea și nu încercați să fiți inteligenți atunci când vă scrieți paginile de manual. O mulțime de lucruri sunt posibile în nroff și nu sunt acceptate de acest analizator. De exemplu, nu încercați să vă jucați cu \c pentru a întrerupe procesarea textului (așa cum fac 40 de pagini de pe calculatorul meu). Sau, asigurați-vă că puneți argumentele macro pe aceeași linie cu macroul în sine. Știu că este valabil în nroff, dar ar complica prea mult analizatorul pentru a fi gestionat.

Desigur, o altă posibilitate este de a utiliza un alt format, mai ușor de tradus (cum ar fi POD folosind po4a::pod, sau unul din familia XML cum ar fi SGML), dar datorită po4a::man nu mai este necesar. Acestea fiind spuse, dacă formatul sursă al documentației dvs. este POD sau XML, poate fi inteligent să traduceți formatul sursă și nu acest format generat. În majoritatea cazurilor, po4a::man va detecta paginile generate și va emite un avertisment. Acesta va refuza chiar să proceseze paginile generate de POD, deoarece aceste pagini sunt gestionate perfect de po4a::pod și deoarece omologul lor nroff definește o mulțime de macrocomenzi noi pentru care nu am vrut să scriu suport. Pe calculatorul meu, 1432 din cele 4323 de pagini sunt generate de POD și vor fi ignorate de po4a::man.

În majoritatea cazurilor, po4a::man va detecta problema și va refuza să proceseze pagina, emițând un mesaj adaptat. În unele cazuri rare, programul se va finaliza fără avertisment, dar rezultatul va fi greșit. Astfel de cazuri sunt numite „erori” ;) Dacă întâlniți un astfel de caz, asigurați-vă că raportați acest lucru, împreună cu o remediere atunci când este posibil…