Re:

[email protected] (Davide Pastore) Mon, 15 Mar 2021 12:44:26 +0100
Newsgroups php.doc.it
Message-ID <CAMjJeRybsqDBodaUdA=aE8ACS340UznaHM--TJoT2E3g3reAyg@mail.gmail.com>
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 [email protected] (che ho aggiunto
come destinatario di 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. 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 <[email protected]>
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.
>