Esempi

Esempio di come cominciare una nuova traduzione

Per questo esempio useremo la lingua francese

   git pull
   cd webwml
   mkdir french
   cd french
   cp ../english/.wmlrc ../english/Make.* .
   echo 'include $(subst webwml/french,webwml/english,$(CURDIR))/Makefile' > Makefile
   mkdir po
   git add Make* .wmlrc po
   make -C po init-po
   git add po/Makefile po/*.fr.po

Edita il file .wmlrc e cambia:

'-D CUR_LANG=English' in '-D CUR_LANG=French'
'-D CUR_ISO_LANG=en' in '-D CUR_ISO_LANG=fr'
'-D CUR_LOCALE=en_US' in '-D CUR_LOCALE=fr_FR'
'-D CHARSET=iso-8859-1' in maniera appropriata.
Il francese casualmente ha la stessa codifica dei caratteri dell'inglese quindi non serve modificarlo, ma è comunque possibile cambiarlo per altre lingue.

Edita Make.lang e cambia 'LANGUAGE := en' in 'LANGUAGE := fr'. Nel caso tu stia traducendo in una lingua che usa i caratteri multi-byte dovresti cambiare anche altre variabili in quel file, per maggiori informazioni leggi ../Makefile.common e forse altri esempi funzionanti come la traduzione cinese.

Vai nella directory french/po e traduci tutto quello che è nei file PO. Questo dovrebbe essere abbastanza facile.

Sii sempre sicuro di aver copiato il Makefile dentro ad ogni directory che hai intenzione di tradurre. Ciò è necessario poiché il programma make viene utilizzato per convertire i file .wml in HTML e make usa i Makefile.

Quando si finisce di aggiungere pagine e modificare i file, si deve eseguire

   git commit -m "Inserire qui il messaggio di commit"
   git push

dalla directory webwml. A questo punto si può cominciare a tradurre le pagine.

Esempio di traduzione di una pagina

Per questo esempio useremo la traduzione francese del contratto sociale

   cd webwml
   ./copypage.pl /english/social_contract.wml
   cd french

Questo aggiungerà automaticamente l'intestazione translation-check, riferita al file inglese originale. Inoltre crea la directory di destinazione e il Makefile, se necessari.

Modifica il file social_contract.wml traducendo il testo. Non tradurre alcun link e non cambiarli in alcun modo. Se vuoi cambiare altro chiedilo nella lista debian-www. Quando hai finito, esegui

   cvs commit -m "short description of the changes you made" social_contract.wml

Esempio su come aggiungere una nuova directory

In questo esempio aggiungiamo la versione francese della directory intro/

   cd webwml/french
   mkdir intro
   cd intro
   cp ../Makefile .
   git add Makefile
   git commit -m "added the intro dir to git"
   git push

Assicurati che la nuova directory abbia il Makefile e sia stata inserita (tramite commit) nel CVS. Altrimenti il make darà un errore

Esempio di conflitto

Questo esempio mostra un commit che non va a buon fine perché la copia sul repository è stata modificata dopo l'ultimo git pull.

Hai cambiato il file file foo.wml. Quindi:

    git add foo.wml
    git commit -m "fixed a broken link"
    git push

mostrerà:

To salsa.debian.org:webmaster-team/webwml.git
 ! [rejected]                master -> master (fetch first)
error: failed to push some refs to '[email protected]:webmaster-team/webwml.git'

o qualcosa di simile :)

Questo significa che le tue modifiche non sono state pubblicate sul repository git a causa di conflitti.
Dovrai controllare cosa sia andato storto, risolvere i conflitti e tentare di fare nuovamente un commit/push.