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 < garakkio@gmail.com> 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 < > 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-itzNNWϛ�k >> ����P�O> 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 >>>>> >>>>>