Gentoo Archives: gentoo-docs-it

From: Agostino Sarubbo <ago@g.o>
To: gentoo-docs-it@l.g.o
Subject: [gentoo-docs-it] Nuovi traduttori - cosa/come fare
Date: Wed, 01 Feb 2012 14:30:08
Message-Id: 2414887.ig86pWgr1Q@devil
Salve a tutti.

Dando uno sguardo qua e la in giro per freenode, ho trovato altre persone 
interessate alla traduzione delal documentazione gentoo.
Ho raccomandato di joinare #gentoo-docs-it e di iscriversi alla mailing list, 
e se era possibile leggere un po' di archivi.

Questa mail vuole essere nient'altro che uno schema riassuntivo di cosa e come 
fare.

Non ho accesso alla lista di iscritti, ma la mail dovrebbe essere indirizzata 
a:
damiano
mastro
darkbasic
darkness-hack
carlocaponi
ackaos
cpglsn
kiuma

Andiamo al dunque.

Ai tempi di scen, era consuetudine auto-assegnarsi interi documenti, e questo 
creava una certo impegno dal punto di vista 'scadenze', quindi è venuta fuori 
l'idea git.

Avere un repository git, significa che non c'è nulla da auto-assegnarsi e che 
si può contribuire in base al tempo a disposizione senza avere il timore di 
essere in ritardo con la scadenza ( cosa che prima più o meno c'era ).

Per iniziare a lavorare bisogna avere un account su gitorius; il link del 
repository è il seguente:
https://gitorious.org/+gentoo-doc-it/documentazione-italiana-gentoo-
linux/documentazione-italiana-gentoo-linux

Dopo aver creato il vostro account gitorius, provvedete a mandarmi il nome 
account via mail in modo che possa aggiungervi per avere permessi di 
scrittura.

Per chi non è pratico di git niente paura, come potete vedere nel repository 
c'è un mini-howto in pdf (git_howto.pdf) che vi spiegherà cosa fare passo 
passo.

E' chiaro che git è molto più complesso rispetto a quel che la guida dice, ma 
per il lavoro che dobbiamo fare noi, sono più che sufficienti quei pochi 
comandi elencati.
Se qualcuno ha da proporre miglioramenti per la guida, ben venga ;)

La pagina di riferimento sulle traduzioni è la seguente:
http://dev.gentoo.org/~ago/trads-it.xml

e questa è la guida su xml:
http://www.gentoo.org/doc/it/xml-guide.xml


Andando sulla pratica, come realmente tradurre?

Per prima cosa aggiorniamo il nostro repository git, quindi:
git pull origin master

poi scegliamo un documento dalla lista, esempio:
4e. Aggiornamento GCC

Passando il cursore sulla rev EN, leggiamo il nome reale del file xml che in 
questo caso è: gcc-upgrading.xml

successivamente andiamo a vedere quali sono le differenze applicate al 
documento inglese per poi riportarle sulla nostra traduzione it. , quindi 
cliccare in questo caso su: 1.29 - 1.32 ( http://sources.gentoo.org/cgi-
bin/viewvc.cgi/gentoo/xml/htdocs/doc/en/gcc-
upgrading.xml?r2=1.32&r1=1.29&diff_format=l )

A questo punto il diff ci mostra cosa è realmente cambiato, quindi con il 
vostro editor di testo preferito andrete a modificare il file (it) e apportare 
le modifiche in base a quello che il diff mostra.

Se il file non è già presente sul repository, potete tranquillamente scaricare 
la versione xml su http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo/
 e aggiungerla al repository.

Per verificare se il vostro xml è corretto dal punto di vista di tag e 
sintassi potete utilizzare il tool xmllint ( da dev-libs/libxml2 ).


Nel repository potete vedere diverse cartelle:
In bump ci sono i file già tradotti e pronti per essere revisionati e 
committati.
Nelle altre cartelle ci sono i file da tradurre.

Oltre alla documentazione abbiamo intenzione di tradurre i manuali di portage.
Mi scuso per la mail inviata in html, ma è possibile leggere qualcosa qui:
http://old.nabble.com/Traduzione-manuali-portage---come-fare-td33208712.html

Se un documento risulta non aggiornato e non è ne nella cartella bump ne in 
altre cartelle controllate che non sia su bugzilla:
https://bugs.gentoo.org/buglist.cgi?order=Importance;short_desc=docs-
it;query_format=advanced;short_desc_type=allwordssubstr;component=%5BIT%5D;product=Doc%20Translations

Spero di non aver dimenticato nulla, non esitate a chiedere in caso di dubbi.

-- 
Agostino Sarubbo		ago -at- gentoo.org
Gentoo/AMD64 Arch Security Liaison
GPG: 0x7CD2DC5D

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies

Subject Author
Re: [gentoo-docs-it] Nuovi traduttori - cosa/come fare Andrea <gentoolinux46@×××××.com>
Re: [gentoo-docs-it] Nuovi traduttori - cosa/come fare Mariano <armaoin@×××××.com>
Re: [gentoo-docs-it] Nuovi traduttori - cosa/come fare Daniele Segato <daniele.segato@×××××.com>
Re: [gentoo-docs-it] Nuovi traduttori - cosa/come fare Jamie Learmonth <jamie-lists@×××××××××××××.com>