Re: contribuire alla documentazione italiana di php

Ciao Massimiliano,

grazie per il tuo contributo. Ho accettato la PR facendo il push
direttamente sulla repository principale e non su GitHub (che è un mirror).
Ho fatto un altro commit
<https://github.com/php/doc-it/commit/88c83f16d100f4d984bca5f7a21989a1b9a1f96a>
con
ulteriori modifiche perché ho notato che alcuni aggiornamenti non erano
stati portati.
Ti faccio qui un riepilogo veloce:

   1. la scelta di portare "stylesheet" al rigo successivo è legata al
   fatto che la versione inglese era fatta allo stesso modo e per questo
   motivo sarà più facile da gestire in futuro;
   2. alcune parti (tipo "PHP 7" o "int") non erano state aggiornate.

Ad ogni modo se hai altre domande non esitare a chiedere. Ho fatto una
prova a lanciare la build sulla mia macchina e purtroppo ora non funziona
davvero (anche se l'errore che viene fuori è differente rispetto a quello
presente sul log che ci arriva per e-mail ogni 4 ore). Se ti vuoi divertire
in tal senso, puoi lanciare questo comando dalla cartella "base":

php configure.php --with-lang=it --enable-xml-details

Se dovessi aver bisogno di supporto non esitare a chiedere. Nel frattempo
sono in attesa che qualcuno si faccia vivo e chi ci ri-sistemi la build, in
modo che almeno sputi fuori gli errori giusti.

Buona giornata,
Davide Pastore

Il giorno gio 28 gen 2021 alle ore 14:43 Massimiliano Arione <
[email protected]> ha scritto:

> Spero di aver fatto giusto: https://github.com/php/doc-it/pull/1
>
> grazie per l'aiuto!
> ciao
> --
> Massimiliano Arione
>
>
> Il giorno gio 28 gen 2021 alle ore 12:43 Davide Pastore <
> [email protected]> ha scritto:
>
>> Ciao Massimiliano,
>>
>> l'errore che si ripete da tempo sulla build non è reale, ma è legato ad
>> un problema della migrazione che non tiene conto dell'ultima versione
>> attualmente presente su Git, dato che la traduzione italiana è attualmente
>> flaggata come "not maintained" (o qualcosa di molto simile). Ho già chiesto
>> per due volte di risolvere il problema, in modo da rendere il processo
>> della build uguale a prima, ma finora non ho avuto chiarimenti in merito e
>> per questo non sono particolarmente felice.
>>
>> 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. Un utente aveva cominciato a lavorarci ma a quanto
>> pare non ha continuato. Nel frattempo possiamo dare un'occhiata al suo
>> lavoro 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 di GitHub che
>> contiene tutti i file cambiati dalla versione del file non aggiornato
>> (italiano) a quella dell'ultima inglese. In questa lista dovrai andare a
>> trovare il file che stai provando ad aggiornare ed 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. A questo punto 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 qualsiasi altra informazione, non esitare a
>> chiedere.
>>
>> Buona giornata,
>> Davide
>>
>> Il giorno gio 28 gen 2021 alle ore 10:34 Massimiliano Arione <
>> [email protected]> ha scritto:
>>
>>> Ciao Davide,
>>> torno alla carica dopo un po' di tempo.
>>> Sto ancora cercando di capire il flusso di build della documentazione,
>>> almeno per provare a risolvere quell'errore che si ripete da tempo.
>>> Ho installato sulla mia macchina php/phd ma non credo di aver ben capito
>>> come funziona, se provo a eseguire il file render.php dandogli in pasto un
>>> xml ottengo un sacco di notice e qualche warning, più una manciata di file
>>> in una cartella output (che tra l'altro non è nemmeno in .gitignore
>>> Hai suggerimenti?
>>> Pensi che possiamo prenderci qualche minuto in una qualsiasi chat per
>>> rivedere la situazione insieme?
>>>
>>> grazie
>>> ciao
>>> --
>>> Massimiliano Arione
>>>
>>>
>>>
>>> Il giorno gio 31 dic 2020 alle ore 10:22 Davide Pastore <
>>> [email protected]> ha scritto:
>>>
>>>> Ciao Massimiliano,
>>>>
>>>> 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 che ci dà
>>>> la possibilità di accettare più facilmente le patch dalla comunità ma allo
>>>> stesso tempo ha rotto alcuni script utilizzati per la costruzione delle
>>>> diff dei file (in modo da tradurre solo il delta e non l'intero file da
>>>> zero ogni volta che la versione inglese viene aggiornata). Oltre a questo,
>>>> nel tutorial troverai riferimenti all'Online Documentation Editor (
>>>> https://edit.php.net/) che è anch'esso non più funzionante dopo questa
>>>> migrazione. Aspettavo questa migrazione da diversi anni e sono molto felice
>>>> di questo salto, anche se bisogna un po' sistemare gli strumenti utilizzati
>>>> (revcheck tra tutti), come ti dicevo in precedenza.
>>>>
>>>> *Chi siamo?*
>>>> Mi dispiace dirlo, ma da più di un paio d'anni sono stato l'unico che
>>>> ha contribuito. Le mie modifiche fanno in modo che la documentazione
>>>> continui a galleggiare, evitando che la build rimanga rotta troppo a lungo.
>>>>
>>>> *Nel frattempo, 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. Appena avremo il revcheck sistemato, potrai
>>>> procedere con delle nuove modifiche o aggiunte.
>>>>
>>>> Se dovessi aver bisogno di una mano, chiedi senza alcun problema.
>>>>
>>>> Buona giornata,
>>>> Davide Pastore
>>>>
>>>>
>>>> Il giorno mer 30 dic 2020 alle ore 15:55 Massimiliano Arione <
>>>> [email protected]> ha scritto:
>>>>
>>>>> Ciao Davide,
>>>>> ho letto or ora del porting della documentazione di php su github e
>>>>> dal repo principale ho trovato subito quello della traduzione italiana, di
>>>>> cui mi pare tu sia il responsabile.
>>>>> Volevo capire quale potrebbe essere il modo migliore per dare il mio
>>>>> contributo, perché purtroppo il repo stesso manca di README (o di altre
>>>>> istruzioni)
>>>>>
>>>>> grazie in anticipo
>>>>> saluti
>>>>> --
>>>>> Massimiliano Arione
>>>>>
>>>>>