Leggere il file README.txt in docs-common/common/entities e seguire le indicazioni per creare le nuove entità.

Una volta create le entità comuni per la lingua ed eseguito il commit dei file al CVS, creare i file di lingua per le note legali:

cd docs-common/common/
cp legalnotice-opl-en_US.xml legalnotice-opl-pt_BR.xml
cp legalnotice-relnotes-en_US.xml legalnotice-relnotes-pt_BR.xml	

	Non tradurre le note legali
	Per assicurare che sia legalmente equivalente in tutte le lingue, non tradurre la OPL.

Quindi eseguire il commit al CVS anche di quei files:

cvs add legalnotice-*-pt_BR.xml
cvs ci -m 'Added legal notices for pt_BR' legalnotice-*-pt_BR.xml

Successivamente, creare la filigrana di bozza per la lingua nella cartella docs-common/images/:

cd docs-common/images/
cp watermark-en_US.svg watermark-pt_BR.svg

Tradurre gli elementi di testo nell'SVG. Quindi aggiungere il file SVG tradotto al Makefile, produrre il PNG ed eseguire il commit dei risultati:

make watermark-pt_BR.png
cvs add watermark-pt_BR*
cvs ci -m 'Added pt_BR images' Makefile watermark-pt_BR*

Cambiare la directory

In un terminale, entrare nella directory del documento che si vuole tradurre:

cd ~/docs/translation-quick-start-guide/

Aggiunta della lingua all'elenco

Per aggiungere la propria localizzazione, si dovrà trovare e cambiare l'appropriato elenco di località. Alcuni documenti stanno usando il file po/LINGUAS, come standardizzato nel progetto GNOME, per tracciare le localizzazioni. Alcuni documenti non sono ancora stati aggiornati a questo standard. Se si trova che il modulo che si sta traducendo non è stato aggiornato, si notifichi il Fedora Documentation Project o si invii una segnalazione d'errore usando Bugzilla.

Nel file po/LINGUAS, aggiungere il codice della lingua tradotta all'elenco, utilizzando il proprio editor preferito. Ad esempio,

vi po/LINGUAS

Premere 'a' per modificare ed aggiungere il codice di linguaggio. Una volta aggiunto, salvarlo ed uscire dall'editor.

Si prega di lasciare questo elenco in ordine alfabetico.

Creare il file PO

Creare un nuovo file .po per la lingua:

make po/pt_BR.po

Tradurre le stringhe

Per tradurre il file, usare la stessa applicazione usata per tradurre il software:

kbabel po/pt_BR.po

Controllare l'integrità

Prima di inviare i cambiamenti, controllare l'integrità dell'XML con il seguente comando. Questo assicura una corretta compilazione a tutti gli utenti.

make html-pt_BR

E' possibile leggere i risultanti file HTML con un navigatore Web. Se non viene creato alcun HTML, si potranno trovare i messaggi(o) d'errore nell'output. Si prega di risolverli prima di eseguire il commit.

	Provare sempre la traduzione
	Non passare al passo successivo o eseguire il commit dei cambiamenti finchè non si è verificato il proprio lavoro. Cambiamenti errati possono rompere documenti per altri utenti, editori, e applicazioni automatizzate.

Eseguire il commit del lavoro

Prima di eseguire il commit del file .po. si deve essere sempre sicuri che l'HTML sia generato con successo. Si potranno osservare la percentuale di completamento od altri utili messaggi al momento del commit.

cvs ci -m 'Translating... 400/10/126' po/pt_BR.po