Gestione pratica delle traduzioni

Per internazionalizzazione (spesso indicata nei testi inglesi come “i18n” per abbreviare) si intende l'operazione per mezzo della quale un programma o un gruppo di programmi sono messi in grado di supportare diversi linguaggi.

Per localizzazione (spesso indicata nei testi inglesi come “l10n” per abbreviare), si intende l'operazione per mezzo della quale vengono forniti ad un programma tutte le informazioni necessarie per gestire i suoi ingressi ed uscite in un modo che risulti corretto in una certa lingua ed in un certo ambiente.

Come suggerito dalla nota, il modo migliore per fornire un software tradotto è di fornire delle tabelle per ogni lingua in cui si realizzi la corrispondenza striga originale - stringa tradotta. Le varie utilità che compongono gettext permettono di gestire queste corrispondenze tramite semplici file di testo.

L'operazione di traduzione di un programma richiede da parte del traduttore la modifica del cosiddetto “file PO”.

PO significa Portable Object, per distinguere tali file dai file MO, ovvero Machine Object. Il formato di file PO è stato per la prima volta implementato dalla Sun sul sistema Solaris, basandosi su uno standard della Uniforum.

Nei file PO si concretizza l'associazione tra ciascuna stringa originale marcata come traducibile e la traduzione in una particolare lingua di destinazione. Per ogni lingua supportata dal programma esiste un file di nome CODICE_LINGUA.po che contiene tutte le stringhe marcate come traducibili e le loro traduzioni. I file che hanno come estensione .pot sono delle traduzioni “vergini”, contengono cioè solo le stringhe da tradurre ed i segnaposto per le traduzioni: tali file vanno usati quando si comincia una nuova traduzione.

I file MO sono dei file binari pensati per essere letti dai programmi. Sebbene derivino dai file PO, il formato di tali file può differire da sistema a sistema. Nei sistemi GNU i file con estensione .gmo sono file MO nel formato GNU.

Oltre ad una architettura utile agli sviluppatori per marcare le stringhe da tradurre, gettext fornisce dei programmi utili per la creazione, l'aggiornamento, la fusione e la codifica dei file PO.

L'uso di questi programmi non verrà trattato, rimandando alla già citata pagina Info di gettext ed alle pagine di manuale dei relativi programmi.

è bene tenere presente che i progetti legati a GNOME fanno uso di file sorgenti che non sono gestiti direttamente da gettext, come ad esempio i file con sintassi XML. Per ovviare a questo problema vengono forniti delle utilità, raggruppate sotto il nome di intltool, che in pratica fanno da filtro. FIXME!!!

Il modo più semplice di ottenere un file PO è di farselo dare da chi già lo ha. In particolare della lista dei moduli orfani della pagina dei traduttori italiani di GNOME e dalla lista delle statistiche di traduzione di GNOME. (FIXME: inserire i rispettivi collegamenti)

I file PO qui disponibili sono generati in modo automatico ad intervalli regolari. Se si ha paura di pasticciare, questo è il modo consigliato per procurarsi il file.

In alternativa è possibile crearsi da soli il file PO. Per fare ciò è necessario avere sia i sorgenti dell'applicazione (meglio se la versione di sviluppo da CVS), sia intltool installato nel proprio sistema.

Per creare quindi da soli un nuovo file pot si procede come segue:

Se non vengono evidenziati errori, allora è stato creato il file applicazione.pot, ossia il modello da usare per la propria traduzione.

A questo punto è sufficiente copiare o rinominare il file applicazione.pot come it.po per proseguire poi con l'effettiva traduzione.

I file PO, come preannunciato, non sono altro che file di testo semplice che elencano le stringhe segnate come da tradurre dagli sviluppatori e lasciano dello spazio per inserire le traduzioni. Ovviamente questi file debbono rispettare una certa sintassi.

Per poterli editare è quindi sufficiente un editor di testo. L'unica richiesta dei file PO per i moduli del progetto GNOME è che il file PO sia codificato in UTF-8, quindi anche l'editor di testo deve poter leggere e salvare in tale set di caratteri.

L'editor di testo fornito con lo GNOME Deskop è sufficiente per iniziare a lavorare, ma non è adatto per la modifica e la manutenzione di grosse traduzioni. Esistono programmi specifici per la gestione dei file PO quali Gtranslator e KBabel (questo secondo fa parte dell'ambiente desktop KDE), ma la loro descrizione esula dagli scopi di questo documento.

Una volta scelto quindi il proprio editor di testo o programma specifico per i file PO preferito, per inizare la traduzione è sufficiente aprire con questo il file it.po appena generato o scaricato da Internet.

Il seguente è un esempio di file PO appena generato; i numeri sulla sinistra non compaiono nel file, ma saranno utili nel seguito per poter fare riferimento ai vari elementi.

 1  # SOME DESCRIPTIVE TITLE.
 2  # Copyright (C) YEAR Free Software Foundation, Inc.
 3  # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 4  #
 5  #, fuzzy
 6  msgid ""
 7  msgstr ""
 8  "Project-Id-Version: PACKAGE VERSION\n"
 9  "PO-Revision-Date: YEAR-MO-DA HO:MI +ZONE\n"
10  "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
11  "Language-Team: LANGUAGE <LL@li.org>\n"
12  "MIME-Version: 1.0\n"
13  "Content-Type: text/plain; charset=CHARSET\n"
14  "Content-Transfer-Encoding: 8bit\n"
15
16  #: src/main.c:32
17  msgid "First string"
18  msgstr ""
19  
20  #: src/main.c:48
21  msgid "Second string"
22  msgstr ""

In questo file è possibile evidenziare:

Ogni messaggio da tradurre è racchiuso tra due " e preceduto dalla parola chiave msgid; il corrispondente messaggio tradotto va inserito tra la coppia di virgolette subito dopo, quelle precedute dalla parola chiave msgstr. Ogni coppia di messaggi è preceduta da un commento che indica il file e la riga da cui il messaggio da tradurre è prelevata; nel commento possono anche essere presenti informazioni utili per la traduzione, rese disponibili dagli sviluppatori, o indicazioni su particolari formati che saranno spiegati in la sezione chiamata “Sintassi dei file PO”.

Per poter completare la traduzione di questo file è necessario modificare nel modo opportuno l'intestazione e insereire le traduzioni dei messaggi negli appositi spazi, come spiegato qui di seguito:

La prima cosa da modificare è l'intestazione del file PO. I dati da modificare sono quelli scritti in maiuscolo, in particolare:

Anche le righe di commento all'intestazione vanno modificate secondo le indicazioni che seguono:

Tra la riga 2 e 3 andrebbe poi aggiunta una ulteriore riga di commento

   # This file is distributed under the same license as the applicazione package
  

Infine, per completare questa prima fase, va elimata la riga 5, quella con la scritta fuzzy. Se non si cancella questa riga, infatti, anche traducendo tutti i messaggi della traduzione, questa non verrà poi compilata. Per maggiori informazioni sulle stringhe fuzzy e sul loro uso, consultare ???.

Il file PO d'esempio, dopo aver apportato le operazioni preliminari alla traduzione descritte in la sezione chiamata “Modifica dell'intestazione”, appare come segue (le parole in corsivo sono quelle variabili in funzione dei dati del traduttore e/o dell'applicazione):

 1  # Italian tranlation of Applicazione.
 2  # Copyright (C) 2001-2005 Free Software Foundation, Inc.
 3  # This file is distributed under the same license as the applicazione package
 4  # Pluto Bar <pluto@bar.net>, 2005.
 4
 5
 7  msgid ""
 8  msgstr ""
 9  "Project-Id-Version: applicazione x.y.z"
10  "PO-Revision-Date: 2005-02-12 10:45 +0100\n"
11  "Last-Translator: Pluto Bar <pluto@bar.net>\n"
12  "Language-Team: Italian <tp@lists.linux.it>\n"
13  "MIME-Version: 1.0\n"
14  "Content-Type: text/plain; charset=UTF-8\n"
15  "Content-Transfer-Encoding: 8bit\n"
16
17  #: src/main.c:32
18  msgid "First string"
19  msgstr ""
20  
21  #: src/main.c:48
22  msgid "Second string"
23  msgstr ""

A questo punto per completare la traduzione è sufficente modificare le righe 19 e 23 in modo tale che tra le "" di ciascuna riga ci sia la traduzione di quanto riportato alla riga che precede.

In pratica, alla fine della fase di traduzione la parte finale del file PO apparirà come segue:

[...]
16
17  #: src/main.c:32
18  msgid "First string"
19  msgstr "Prima stringa"
20  
21  #: src/main.c:48
22  msgid "Second string"
23  msgstr "Seconda stringa"

A traduzione completata è possibile procedere con la fase di revisione ed invio del file, secondo quanto previsto dal proprio gruppo di traduzione. Ovviamente sarebbe opportuno verificare che la traduzione non presenti errori tecnici, ossia che dopo le modifiche apportate il file applicazione.it.po rispetti la sintassi dei file PO.

Forse il lettore ha già notato come nel file PO di esempio presentato il carattere " (le virgolette, in Unicode identificato come U+0022 QUOTATION MARK) sia stato usato per racchiudere il messaggio originario e quello tradotto

L'uso di tale carattere nei file PO è riservato quindi come delimitatore di messaggio. Tutto ciò che è racchiuso tra due vigolette è il messaggio originario se preceduto dalla parola chiave msgid, è il messaggio tradotto se preceduto dalla parola chiave msgstr. Per poter inserire nel messaggio un carattere virgolette si deve procedere al così detto escaping, come nel seguente esempio:

    #: src/main.c:32
    msgid "This file is \"odd\""
    msgstr "Questo file è \"strano\""

La sequenza di caratteri \" è definita sequenza di escape; funge infatti da scappatoia per poter aggirare una costrizione.

Risulta evidente quindi che all'interno di un messaggio il carattere \ (backslash, in Unicode U+005C REVERSE SOLIDUS) è un carattere riservato per l'escaping. Per questo motivo per poter inserire un tale carattere in un messaggio è necessario farne l'escaping, in pratica raddoppiarlo.

Altre due sequenze di escape frequenti sono quella per i caratteri non stampabile di fine linea e di tabulazione, rispettivamente resi all'interno del messaggio con le sequenze di escape \n e \t. Ad esempio per inserire un a capo alla fine di un messaggio si avrebbe:

    #: src/main.c:32
    msgid "Reading configuration\nReading personal data\nDone"
    msgstr "Lettura della configurazione\nLettura dei dati personali\nFatto"
    

Che una volta stampato a schermo apparirebbe come

Lettura della configurazione
Lettura dei dati personali
Fatto

Quando un programma produce un messaggio da mostrare all'utente, non sempre è possibile conoscere a priori l'esatto contenuto del messaggio. Basta pensare, ad esempio, ai risultati di una ricerca, o al conteggio degli oggetti presenti in una directory. Bisogna poter gestire la presenza di elementi variabili all'interno del messaggio.

Il linguaggio “principe” dei sistemi Unix è il C, per cui si comincerà a prendere in esame la sua sintassi per mezzo di due messaggi di esempio con 3 “segnaposto” per altrettante sostituzioni.

   #: ../src/main.c:32
   #, c-format
   msgid "Could not open \"%s\""
   msgstr "Impossibile aprire \"%s\""
  
   #: ../src/main.c:48
   #, c-format
   msgid "%d files, %ld M total"
   msgstr "%d file, in totale %ld M"

La prima sostituzione, %s indica che tale elemento verrà sostituito con una stringa (nel senso del linguaggio C, ossia un vettore di caratteri, ivi incluso il carattere spazio o altro). Il traduttore deve aver cura di replicare tale segnaposto nel messaggio tradotto, pena la presenza di errori di compilazione. Nel caso %s è il nome di un file, o di una directory, o di un qualsiasi altro oggetto apribile dall'applicazione.

Nel secondo messaggio invece abbiamo il segnaposto per i numeri, %d, nella sua forma semplice ed in una delle possibili forme per specificare in modo più preciso il formato.

è opportuno notare come entrambi i messaggi presentino il commento #, c-format che indica, per l'appunto, che il messaggio segue il formato del linguaggio C. Il questi messaggi il carattere percentuale (%) serve da carattere inizale per i segnaposto e non può essere usato come simbolo. Se si ha necessità di inserilo, allora deve essere raddoppiato, come nell'esempio che segue.

   #: ../src/main.c:12
   #, c-format
   msgid "Percentage: %d %%"
   msgstr "Percentuale: %d %%"

Risulta evidente come la difficoltà maggiore sia quella di capire con cosa saranno sostituiti i %s. A questo problema talvolta solo una lettura del codice o un accorto commento da parte degli sviluppatori può dare soluzione.

Sebbene non frequente, spesso potrebbe rendersi necessario l'inversione dell'ordine con cui i segnaposto compaiono nel messaggio. Tale inversione è praticabile senza problemi nè timori quando si tratta di due sengaposto differenti (ad esempio un %s ed un %d). L'inversione è completamente gestita da gettext ed il traduttore è libero di porre i due elementi come meglio crede l'uno rispetto all'altro.

L'inversione è anche possile nel caso di segnaposto uguali, a patto di usare l'accortezza di “numerare” in un certo modo i segnaposto secondo l'ordine assunto nel messaggio originale.

L'esempio che segue dovrebbe essere sufficiente per capire il funzionamento: i due %s rappresentano il primo il nome di un file ed il secondo il nome di un utente proprietario del file.

   #: src/chown-core.c:152
   #, c-format
   msgid "ownership of %s retained as %s\n"
   msgstr "mantenuto %2$s come proprietario di %1$s\n"

In questo modo è stato possibile mantenere una forma chiara in Italiano senza dover essere limitati dalla presenza e dalla posizione dei due segnaposto.

Nell'esempio del paragrafo precente relativo al numero di file in una cartella, non si è tenuto conto del fatto che lingue diverse possono usare diverse scritture a secondo del numero di elementi. In Italiano, come in Inglese, esistono solo la forma singolare (numero di elementi pari ad 1) e quella plurale (numero di elementi maggiore di 1); In altre lingue però si possono avere 3 forme diverse (1, 2, molti).

Il framework gettext fornisce la possibilità di gestire queste necessità, consentendo di usare 2 o più forme diverse a secondo del numero di elementi che si hanno.

Nella pratica il file PO presenta voci simili a quelle dell'esempio che segue.

  msgid ""
  msgstr ""
  "Project-Id-Version: addressbook 2.0.0\n"
  [...]
  "MIME-Version: 1.0\n"
  "Content-Type: text/plain; charset=UTF-8\n"
  "Content-Transfer-Encoding: 8bit\n"
  "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  [....]

  #: ../addressbook/addressbook-view.c:149
  #, c-format
  msgid "Addressbook folder has %d contact"
  msgid_plural "Addressbook folder has %d contacts"
  msgstr[0] "La rubrica corrente presenta %d contatto"
  msgstr[1] "la rubrica corrente presenta %d contatti"

In questo esempio sono riportati parte del messaggio di intestazione ed un messaggio in cui viene fatto uso della forma plurale. A differenza del messaggio di intestazione presentato in la sezione chiamata “Traduzione dei messaggi”, qui vi è una riga, quella che comincia per Plural-Forms:, che dichiara sia che il file farà uso delle forme plurali, sia che per la lingua si hanno solo 2 forme (nplurals=2) e che la forma plurale si ha quando il numero di elementi è diverso da 1 (plural = (n != 1)).

I messaggi poi che sono da tradurre e che richiedono una forma diversa i plurali, compaiono appaiati come nell'esempio: il primo è relativo alla forma singolare, il secondo alla forma plurale. Da notare che il fatto che ci sia %d sia nel singolare che nel plurale è una scelta degli sviluppatori; sono infatti ammesse anche cose come:

  #: ../addressbook/addressbook-view.c:149
  #, c-format
  msgid "Addressbook folder has only one contact"
  msgid_plural "Addressbook folder has %d contacts"
  msgstr[0] "La rubrica corrente presenta solo un contatto"
  msgstr[1] "la rubrica corrente presenta %d contatti"

Emacs è un editor di testo (e molto altro) un po' particolare. Il suo sviluppo ha via molti anni fa e la sua struttura ed interfaccia risente ancora di questa "vecchiaia". Semplicemente, Emacs segue sue proprie regole ed è da solo un ambiente completo per chi ha necessità di sviluppo.

Non ci si deve aspettare la presenza di dialogi di apertura e salvataggio di file, o pulsanti e caselle di spunta per le opzioni. Emacs è pensato per essere usato senza dover togliere le mani dalla tastiera, senza dover usare il mouse; allo stesso tempo, però, Emacs usa delle scorciatoie non standard, retaggio dei suoi venti anni di gloriosa storia. Ad esempio per selezionare del testo è necessario in primo luogo premere Ctrl-barra spaziatrice per attivare la modalità di selezione, quindi spostarsi (con i tasti freccia o con le scorciatoie per selezionare l'intera parola o riga o paragrafo) fino ad evidenziare la porzione testo voluta. Una volta evidenziato, è possibile copiare il testo con Alt-W oppure tagliarlo con Ctrl-W, quindi incollarlo altrove con Ctrl-Y.

Per imparare ad usare Emacs rimandiamo all'ottimo tutorial in linea. Qui vengono dettagliatamente spiegate tutte le funzionalità per l'editing del testo.

Su un sistema ben configurato, all'apertuta di un file PO, Emacs attiverà il cosiddetto po-mode, ossia renderà disponibili una serie di scorciatoie e funzionalità utili per la gestione di un file PO ed allo stesse tempo "colorerà" il file per evidenziare i diversi elementi.

Emacs è provvisto di diversi mode (o modalità), ognuno dei quali permette all'utente di gestire in modo più semplice il file da editare. Come spiegato in la sezione chiamata “Iniziare una traduzione”, i file PO hanno una certa struttura e debbono rispettare una certa sintassi: ad esempio inserire del testo al di fuori delle virgolette che delimitano un msgstr è un errore che porta alla non compilazione del file PO, così come non inserire uno \n alla fine di un messaggio quando è presente alla fine del msgid.

Emacs, usando il po-mode, permette di:

La cosa importante da capire per usare al meglio il po-mode è che la navigazione nel file è disgiunta dalla modifica dei messaggi. Se infatti avessimo aperto il file PO con un altro editor di testo come gedit, avremmo potuto spostarci nel file solo usando i tasti freccia della tastiera e/o i tasti PagSu e PagGiù; la pressione di un qualsiasi altro tasto (lettere o numeri) avrebbe inserito qualcosa nel punto in cui si trovava il cursore. Il po-mode agisce diversamente: la modifica è permessa solo di un msgstr alla volta e solo dopo aver indicato (premendo il tasto Invio) di volerlo modificare. Qualsiasi pressione di qualsiasi tasto che non sia una scorciatoia quando un msgstr non è stato "aperto", o attivato, per la modifica, non inserisce alcunché nel file PO.

In pratica, usando il po-mode mode bisogna spostarsi sul messaggio da modificare usando i tasti freccia o le scorciatoie fornite dal po-mode stesso, premere Invio per attivare la modifica del messaggio selezionato, modificare il testo del msgstr, ed confermare le modifiche con un Ctrl-C-C che fa tornare nella modalità navigazione. Da notare che durante la fase di modifica del msgstr, sono disponibili tutte le funzionalità di editing del testo semplice di Emacs e la finestra viene divisa in due: la parte superiore con il file PO ed il msgid del messaggio che si sta editando evidenziato, la parte inferiore con in contenuto del msgstr.

Il primo aspetto interessante del po-mode riguarda la modalità fornita per spostarsi all'interno del file.

Oltre infatti alla possibilità di passare una riga sotto o sopra rispetto alla pozione corrente del cursore con i tasti freccia su e freccia giù, o una pagina su e giù, con il po-mode risulta possibile passare direttamente al messaggio precedente o successivo, indipendentemente dal numero di righe da "saltare", discriminando tra messaggio, messaggio tradotto, messaggio fuzzy, messaggio non tradotto e messaggio obsoleto. La seguente tabella elenca scorciatoie ed azione compiuta.