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 pushdalla 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 pushAssicurati 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 pushmostrerà:
To salsa.debian.org:webmaster-team/webwml.git ! [rejected] master -> master (fetch first) error: failed to push some refs to 'git@salsa.debian.org: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.