Re: contribuire alla documentazione italiana di php

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 <pasdavide@gmail.com> 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 < > garakkio@gmail.com> 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 < >> pasdavide@gmail.com> 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 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 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 < >>> garakkio@gmail.com> 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 >>>> >>>>