Traducerea documentaţiilor

Formatul documentaţiei a suferit unele schimbări fundamentale de-a lungul anilor. A început ca HTML, devenind apoi LinuxDoc SGML pentru KDE 1.x şi fiind convertită la formatul DocBook SGML pentru KDE 2.0. Totuşi, un singur lucru nu s-a schimbat: întotdeauna a fost destul de dificil pentru traducători să îşi menţină munca sincronizată cu documentele originale în engleză. De aceea, mai devreme sau mai tîrziu mulţi dintre ei au renunţat la traducerea documentaţiei - dacă au început vreodată. Mai mult decît atît, formatului SGML îi erau necesare instalarea unor programe foarte complexe şi cu numeroase dependenţe şi parametrii cu care nu era uşor de lucrat. Cînd KDE a fost extins în mai multe limbi, problemele legate de limitarea codificării ASCII au devenit foarte importante şi trecerea la XML şi Unicode (în subformatul său UTF-8) părea acceptabilă.

Pentru a uşura întreţinerea documentaţiei fişierele sursă au fost convertite la formatul PO. Acest format a fost deja folosit cu mare succes de traducătorii interfeţei grafice. Matthias Kiefer şi contribuitorii săi au extins aplicaţia KBabel pentru a uşura această sarcină (de exemplu: diferenţe colorate, bază de date pentru traducere, terminator de linie extins). În aceste condiţii aplicaţia KBabel este probabil foarte utilă nu numai pentru traducătorii GUI ci şi pentru traducătorii de documentaţie. Stephan Kulow a realizat Centrul de Ajutor KDE astfel încît acesta poate analiza direct formatul XML™ şi generează din mers cod HTML.

Acesta este scurtul istoric. Şi acum cîteva cuvinte despre conversia propriu-zisă. Dacă documentaţia dumneavoastră este încă în format SGML, este recomandat să citiţi următorul exemplu despre cum să vă convertiţi fişierele. Dacă această conversie este deja făcută, puteţi sări peste această secţiune.

Pentru procesul de conversie este nevoie de documentaţia veche tradusă, adică de fişierul docbook (TRADUS.docbook) în format SGML şi fişierul corespunzător docbook în engleză (ENGLEZA.docbook). Este important ca aceste fişiere să se potrivească. Dacă nu aveţi unul, puteţi lua o versiune mai veche de pe WebCVS sau din CVS. Veţi avea nevoie de cîteva programe pentru conversie. Stephan Kulow a pus la dispoziţie aceste programe în pachetul "kdesdk". În plus vă mai trebuie aplicaţia iconv care este inclusă în majoritatea distribuţiilor Linux® şi care realizează conversia între diferite metode de codare ("iconv --list" afişează o listă cu metodele de codare suportate). Un alt program care nu este inclus în modulul "kdesdk" este msgmerge care face parte din pachetul "gettext" şi este folosit la lucrul cu fişiere PO.

IMPORTANT: Înainte de conversie ar trebui sa schimbaţi entităţile pentru caractere la caracterele corespunzătoare şi să folosiţi metoda de codare corectă pentru conversia la UTF-8. De exemplu, presupunem că scrieţi documentaţie în română. Ar trebui să schimbaţi entitatea &tcedilla; cu caracterul "ţ".

Asta este totul. Pasul cel mai important este apelarea aplicaţiei split2po. Dacă marcarea cu taguri diferă, vor apărea erori. Există două aspecte importante de care trebuie să ţineţi cont:

Un studiu detaliat al aplicaţiei split2po (conversia documentelor care nu sînt sincronizate, de exemplu TRADUS.xml şi ENGLEZA.xml):

Un exemplu de mesaje al aplicaţiei "split2po" ar putea arăta în felul următor:

id="knode-article-cleanup" not in the same paragraphs (245 vs 233)
id="anc-knode-article-cleanup" not in the same paragraphs (246 vs 0)
id="subscribing" not in the same paragraphs (269 vs 249)
id="anc-subscribing" not in the same paragraphs (270 vs 0)
id="fetch-group-list" not in the same paragraphs (271 vs 251)
id="fetch-and-read-news" not in the same paragraphs (251 vs 271)
id="anc-fetch-and-read-news" not in the same paragraphs (311 vs 0)
id="post-and-mail-news" not in the same paragraphs (390 vs 359)
id="anc-post-and-mail-news" not in the same paragraphs (391 vs 0)
id="more-knode-features" not in the same paragraphs (453 vs 417)
id="using-filters" not in the same paragraphs (454 vs 418)
id="anc-using-filters" not in the same paragraphs (455 vs 0)
id="knode-editor-advanced" not in the same paragraphs (463 vs 427)
id="anc-knode-editor-advanced" not in the same paragraphs (464 vs 0)
id="supersede-and-cancel" not in the same paragraphs (497 vs 459)
id="anc-supersede-and-cancel" not in the same paragraphs (498 vs 0)

Să privim în detaliu:

id="knode-article-cleanup" not in the same paragraphs (245 vs 233)

înseamnă că pînă la ultima secţiune cu un ID (de obicei sect2, sect1, capitol, appendix), totul este în regulă. Apoi au fost adăugate paragrafe adiţionale (o separare este făcută de obicei la tagurile <para>, <listitem> sau ceva asemănător). Deci aveţi 12 paragrafe adiţionale în primul fişier (fişierul ENGLEZA.xml) care trebuie şterse pentru generarea fişierului PO. Faceţi o copie de siguranţă deoarece veţi scrie înapoi aceste paragrafe prin crearea unui fişier POT şi apelînd "msgmerge" pe fişierul PO generat. Astfel nu se pierde nimic.

Să privim cea de a doua linie:

id="anc-knode-article-cleanup" not in the same paragraphs (246 vs 0)

Ne spune că există un tag cu numele "id" în primul fişier (ENGLEZA.xml), dar nu şi în cel de-al doilea. În acest caz numele ne furnizează o indicaţie că acesta este id-ul unui tag "ancoră", care trebuie copiat în al doilea fişier. Dacă identificatorul aparţine unui "chapter", "sect1" sau "sect2" de obicei înseamnă că toată secţiunea nu face parte din al doilea fişier. De aici se poate concluziona că este necesar să ştergeţi toată secţiunea din primul fişier pentru a potrivi fişierele între ele.

Să luăm alt caz special:

id="fetch-group-list" not in the same paragraphs (271 vs 251)id="fetch-and-read-news" not in the same paragraphs (251 vs 271)

Aceste două secţiuni trebuie interschimbate în al doilea fişier (TRADUS.xml).

Utilitare necesare pentru comparaţie:

Kate este foarte util pentru comparaţia a două fişiere. Se pot deschide cele două fişiere cu Kate şi să împărţiţi spaţiul de lucru în două pe verticală, astfel încît să aveţi cele două fişiere unul sub celălalt. În plus, Kate are un mod de evidenţiere a codului XML, astfel încît se pot identifica uşor părţile care trebuie şterse.

Un utilitar care compară structura celor două fişiere XML este scriptul "sgmldiff", care produce o diferenţă structurală a celor două fişiere XML şi care ajută la identificarea locaţiei unde au fost adăugate sau şterse paragrafe. Mesajele afişate sînt foarte detaliate după cum se poate observa. Majoritatea diferenţelor nu vor afecta procesul de conversie. Căutaţi în special tagurile <PARA>.

În urma procesului de conversie obţineţi un fişier cu extensia PO.

Fişierul PO rezultat poate fi pus în CVS şi în timpul concatenării automate cu fişierul POT în engleză, noile "msgid"-uri sînt adăugate în fişierul dumneavoastră PO. Prin urmare fişierul PO este sincronizat cu cel original. Noile mesaje vor fi apărea ca netraduse şi "fuzzy". Odată terminat procesul de conversie vă puteţi bucura de simplitatea noului format.