3. Tradurre l'output dei comandi ed il contenuto delle interfacce

1. Scegliete un programma da tradurre :).
2. Verificate che il programma non sia già stato tradotto o che qualcuno non stia già lavorando su tale traduzione (come? scrivete su una delle mailing list per le traduzioni!! Principalmente, per i tool GNU tp@lists.linux.it, scrivendo qualcosa del tipo ``Vorrei tradurre ... qualcuno ci sta già lavorando?'', aspettate una settimana e se nessuno vi risponderà, allora potrete iniziare la vostra traduzione in serenità)
3. Procuratevi i sorgenti del programma che si vuole tradurre (file .tar.gz o .tar.bz2)
4. Decomprimete i sorgenti (tar -xvzf file.tar.gz o tar -xjvf file.tar.bz2)
5. Cercate un file con estensione ``.pot'', file che di norma contengono i template di gettext (find . -name '*.pot')
6. Copiate il file .pot che avete trovato in un file con nome ``it.po''. Il file deve essere copiato nella stessa directory dove si trova il file .pot originale o comunque tutti gli altri file .po. Esempio:

   cp /home/src/pippo-1.2/po/pippo.pot /home/src/pippo-1.2/po/it.po
           
   

7. Aprite il file ``it.po'' con un editor di testo oppure con un tool specifico (kbabel, gtranslator, poedit).
8. Riempite i campi vuoti :). Come?
   • NON toccate MAI ciò che viene dopo ``msgid''. msgid serve a gettext per individuare il messaggio. Per cui, modificando questo campo, il po non funzionerà.
   • dopo ``Language-Team:'' specificate ``Italian <tp@lists.linux.it>'' oppure ``Italian <debian-l10n-italian@lists.debian.org>'', a seconda della mailing list che avrete contattato per verificare la correttezza della traduzione.
   • dopo ``Last-Translator:'' scrivete il vostro ``Nome Cognome <indirizzo@email.com>''
   • al posto di CHARSET, specificate ``ISO-8859-1'' oppure ``UTF-8'' (solo ed esclusivamente se state utilizzando un editor con supporto per UTF-8 e se tale supporto è abilitato). Se non sapete cosa UTF-8 sia, utilizzate ``ISO-8859-1'', a meno che non dobbiate tradurre un componente di GNOME, nel qual caso vi conviene utilizzare ``UTF-8'' e far sì che il vostro editor salvi in tale formato (leggete il manulae del vostro editor!!! in caso contrario, il vostro .po potrebbe non funzionare).
   • dopo ``Project-Id-Version:'' scrivete il nome e la versione del programma con ``nomeprogramma 1.0'' (nomeprogramma spazio 1.0), dove nomeprogramma potrebbe essere, per esempio, ``apache'' ed ``1.3'' la versione del programma stesso.
   • completate anche i campi Project-Id-Version, POT-Creation-Date e PO-Revision-Date, come indicato nel file .po stesso.
   • dopo ogni ``msgstr'', tra ``"'' e ``"'', scrivete la traduzione del messaggio, rispettando il formato indicato nel rispettivo ``msgid''. Esempio:

     msgid ""
     "The domain name is used to construct the base DN of your LDAP directory. "
     "Entering foo.bar.org will give you the base DN dc=foo, dc=bar, dc=org."
     
     msgstr ""
     "Il nome di dominio è utilizzato per costruire il base DN della vostra "
     "directory LDAP. Per esempio, inserendo foo.bar.org verrà utilizzato come "
     "base DN dc=foo, dc=bar, dc=org."
                     
     

     Fate attenzione agli spazi alla fine della riga! Senza lo spazio dopo ``vostra'', il messaggio sarebbe stato ``DN della vostradirectory LDAP''! Allo stesso modo, state attenti a non mettere uno spazio sia all'inizio che alla fine della riga, per non avere doppi spazi!
   • prima di ogni ``msgstr'', gettext inserisce un commento (preceduto da ``#'') che indica la provenienza del messaggio da tradurre, ovvero da che file del programma il messaggio è stato estratto. Questa informazione vi può essere utile per contestualizzare il messaggio (cioè: c'è la parola ``fork'' da tradurre. Si tratta della sezione di un programma che parla di forchette o della ``fork'' come chiamata di sistema? L'unico modo per saperlo è capire dove il messaggio è stato utilizzato, guardando i sorgenti).
9. Una volta che avete riempito tutti i campi, inviate il vostro file .po ad una mailing list, come, per esempio, tp@lists.linux.it o debian-l10n-italian@lists.debian.org chiedendo cosa gli altri ne pensino della vostra traduzione. Questa fase è fondamentale: se avete tradotto un testo, è quasi impossibile che siate anche in grado di correggerlo. Non vedrete gli errori che avete commesso.
10. Apportate le modifiche suggerite dalla mailing list.
11. Inviate il vostro file .po all'autore del programma che avete tradotto o alla mailing list di discussione, con un messaggio simile a:

    Hello!
      Since I believe your wonderful software would be
    more enjoyable by italian users if its messages/menus 
    were written in italian, I took care of translating
    the .po file. The file has been reviewed by members of 
    the mailing list [specificare mailing list] and I 
    believe it to be correct.
      You can find the it.po file in the attachment, and
    I'd like it to be included in the next release of your
    wonderful software.
            
    Cheers,
    [vostro nome]
    

    Se la traduzione ha a che vedere con il sistema Debian ed i menù di installazione di Debian, leggete le prossime sezioni!
12. Bene! Avete tradotto il vostro primo software!

3.1 Suggerimenti

• Utilizzare un programma specifico per le traduzioni può essere di grande aiuto! (provate kbabel, gtranslator o poedit). Anche emacs ha delle funzionalità specifiche per i file .po.
• Per le traduzioni, chiedete consigli sulle varie mailing list! Non coniate neologismi incomprensibili!
• Rifatevi alle traduzioni già esistenti! Consultate il glossario ``ufficiale'' per i traduttori italiani (è importante mantenere una certa uniformità!)
• Preoccupatevi della lunghezza della vostra traduzione e del contesto in cui verrà visualizzata. Ad esempio, se un messaggio di errore è più lungo del previsto e viene visualizzato in una finestrella dove il testo viene mandato a capo automaticamente, allora non è un problema. Se invece dovete tradurre ``History'' nel menù di un browser, probabilmente non potete usare qualcosa come ``Storia dei siti utilizzati più recentemente in ordine di data'', a meno che non vogliate essere voi gli unici utenti di tale browser.