Re:
| From: | Davide Pastore | Date: | Mon, 15 Mar 2021 11:44:26 +0000 |
| Subject: | Re: | ||
| References: | 1 | Groups: | php.doc.it |
| Request: | Send a blank email to doc-it+get-2844@lists.php.net to get a copy of this message | ||
Ciao Luca,
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
come destinatario di 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. 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 gio 11 mar 2021 alle ore 12:02 Luca Alzetta <lucalzetta@gmail.com>
ha scritto:
> Ciao, sono Luca Alzetta da Montereale Valcellina, vorrei dare una mano
> alla traduzione della documentazione riguardo al linguaggio php.
>
> Non so da dove iniziare ma sul Marco Cucinato mi ha dato il tuo
> riferimento per le traduzioni in italiano così ho scritto a te.
>
> Ciao, buona giornata.
>