Re: [DOC-IT] Re: Traduzione documentazione PHP

Ciao Alessandro,

innanzitutto ti ringrazio per l'interessamento nel voler tradurre la
documentazione di PHP. Tutte le comunicazioni inerenti la traduzione
italiana avvengono nella mailing list [email protected] (che ho aggiunto
in CC in questa e-mail e alla quale puoi iscriverti mandando una mail qui
<[email protected]>). Puoi trovare un tutorial non aggiornato
qui <https://github.com/php/doc-base>, dato che effettivamente è stata
fatta una migrazione da SVN verso GIT qualche mese fa che ci dà la
possibilità di accettare più facilmente le patch dalla comunità. Oltre a
questo, nel tutorial potresti trovare riferimenti all'Online Documentation
Editor (https://edit.php.net/) che non è più funzionante dopo questa
migrazione.

*Chi siamo?*
Dopo diversi anni di solitudine, qualche tempo fa si è aggiunto al team
Massimiliano e da pochissimo anche Luca. Le mie modifiche fanno in modo che
la documentazione continui a galleggiare, evitando che la build rimanga
rotta troppo a lungo, quindi in genere non traduco attivamente ma solo in
caso di necessità.

*Come puoi procedere?*
Segui il tutorial e dopo aver fatto il checkout della documentazione (sia
inglese che italiana), datti una lettura a qualche file xml per vedere la
struttura degli stessi. Lo script che genera le differenze tra la versione
inglese e quella di un'altra lingua è revcheck.php ma tuttora (nel branch
master di doc-base <https://github.com/php/doc-base>) resta non migrato per
Git e non funziona come si deve in locale. Nel frattempo possiamo dare
un'occhiata ad una versione funzionante tramite questo link
<http://doc.php.gpb.moe/tools/revcheck/it/> in cui si possono vedere i vari
file da aggiornare, quelli da aggiungere e quelli da rimuovere. Cliccando
su diff ti si aprirà un link che contiene le differenze tra la versione del
file non aggiornato (italiano) e quella dell'ultima inglese. A questo punto
potrai utilizzare il suo diff per modificare in modo corrispondente la
versione italiana. Una volta concluso questo processo, ricordati di
aggiornare il valore *EN-Revision* presente nel commento in testa al file,
utilizzando quello corrispondente della versione inglese. Infine puoi
procedere e creare una pull request sulla repository
<https://github.com/php/doc-it> per proporre la tua modifica.

Se dovessi aver bisogno di una mano, chiedi senza alcun problema.

Buona giornata,
Davide Pastore

Il giorno lun 22 mar 2021 alle ore 13:24 Marco Cucinato <[email protected]>
ha scritto:

> Ciao Alessandro,
>
> > Buonasera Marco,
> > mi piacerebbe aiutare con la traduzione della documentazione di PHP.
> >
> > Da dove posso iniziare?
> >
>
> Da parecchio tempo non seguo più la traduzione, ora il riferimento è
> Davide Pastore.
>
> Ti consiglio di chiedere sulla lista PHP DOC-IT (l'ho aggiunta in Cc:),
> Davide ti saprà dare tutte le informazioni.
>
> Ciao,
> Marco
>
>