Re: Re: Traduzione documentazione PHP
| From: | Davide Pastore | Date: | Tue, 23 Mar 2021 08:58:05 +0000 |
| Subject: | Re: Re: Traduzione documentazione PHP | ||
| References: | 1 2 | Groups: | php.doc.it |
| Request: | Send a blank email to doc-it+get-2851@lists.php.net to get a copy of this message | ||
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 doc-it@lists.php.net (che ho aggiunto
in CC in questa e-mail e alla quale puoi iscriverti mandando una mail qui
<doc-it-subscribe@lists.php.net>). 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 <cucinato@php.net>
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
>
>