Re: Re:

Un'altra cosa: All'header del documento devo aggiungere una riga come questa: <!-- EN-Revision: 763506217efcf05c758932771e33fad3fa64b506 Maintainer: lucalzetta Status: ready --> o almeno mi pare di aver capito così, ma il numero della revisione del file in lingua inglese dove lo posso trovare? Il giorno mar 23 mar 2021 alle ore 10:20 Luca Alzetta <lucalzetta@gmail.com> ha scritto: > Ok, la pull request è la cosa da fare una volta che si è concluso un > lavoro sul proprio ramo? > Se aggiungo un commit il lavoro non vi viene passato? > Ho modificato tre file: histori.xml, filters.xml e comparisons.xml. Sono > visibili sul vostro ramo? > > Ciao > > Il giorno mar 23 mar 2021 alle ore 10:02 Davide Pastore < > pasdavide@gmail.com> ha scritto: > >> Ciao Luca, >> >> non preoccuparti delle cartelle /HEAD ed /INDEX. Sono contento che tu >> abbia volontà nello studio di git. Ci sono davvero tanti argomenti e >> inizialmente non ti volevo inviare una documentazione chilometrica sulla >> quale passare le settimane, per questo ho pensato che potesse essere meglio >> una più veloce e semplice con i comandi base. >> Ho visto la tua pull request su GitHub. Fammi sapere appena hai terminato >> questo ciclo di modifiche in modo da fare una review veloce. Grazie mille. >> >> Buona giornata, >> Davide >> >> Il giorno lun 22 mar 2021 alle ore 08:28 Luca Alzetta < >> lucalzetta@gmail.com> ha scritto: >> >>> Ok, grazie, me ne sono reso conto dopo, ancora qualche passo e metto in >>> ordine tutto. >>> Bye boys >>> >>> Il giorno lun 22 mar 2021 alle ore 07:43 Massimiliano Arione < >>> garakkio@gmail.com> ha scritto: >>> >>>> Luca, devi fare un fork del repository originale e potrai fare push >>>> solo sul tuo repository forkato. >>>> Funziona così per qualsiasi repository git >>>> >>>> ciao >>>> -- >>>> Massimiliano Arione >>>> >>>> >>>> >>>> Il giorno dom 21 mar 2021 alle ore 00:47 Luca Alzetta < >>>> lucalzetta@gmail.com> ha scritto: >>>> >>>>> Sono dunque arrivato al commit e al push del file filters.xml nella >>>>> directory /appendices. Solo che al momento dell'autenticazione >>>>> attraverso >>>>> il browser git mi visualizza questo messaggio. >>>>> $ git push >>>>> remote: Permission to php/doc-it.git denied to lucalzetta. >>>>> fatal: unable to access >>>>> 'https://github.com/php/doc-it/': The >>>>> requested URL >>>>> returned error: 403 >>>>> >>>>> Come posso risolvere? >>>>> >>>>> Ciao e grazie >>>>> >>>>> Il giorno gio 18 mar 2021 alle ore 16:30 Luca Alzetta < >>>>> lucalzetta@gmail.com> >>>>> ha scritto: >>>>> >>>>> > Bene, ho installato Git in locale e sono riuscito a scaricare il >>>>> > repository, i file scaricati, effettivamente, ad un primo sguardo, >>>>> > corrispondono all'elenco della pagina /untraslated.html. A questo >>>>> punto >>>>> > vorrei provare ad aggiornare un piccolo file per testare la >>>>> procedura. >>>>> > Scelgo un file da tradurre, ne salvo una copia e scrivo in italiano >>>>> la >>>>> > parte da tradurre lasciando inalterate >>>>> > l'header e la chiusura del file originale, dopo di che lo carico su >>>>> Git >>>>> > seguendo la breve guida che mi hai gentilmente indicato. >>>>> > E' corretto? >>>>> > Mi resta un dubbio da chiarire, sul mio sistema (Debian GNU/Linux 10 >>>>> > (buster) a 64 bit il progamma di installazione non ha creato le >>>>> directory >>>>> > /HEAD e /INDEX, vengono create in seguito o qualcosa è andato storto? >>>>> > >>>>> > A proposito, ho trovato una fantastica guida sull'uso di git ( >>>>> > https://git-scm.com/book/en/v2), in lingua >>>>> > inglese scaricabile >>>>> > gratuitamente. >>>>> > Sarà la mia prossima lettura 500 pagine non vanno via in mezz'ora >>>>> > :). >>>>> > >>>>> > Il giorno mar 16 mar 2021 alle ore 18:26 Davide Pastore < >>>>> > pasdavide@gmail.com> ha scritto: >>>>> > >>>>> >> Ciao Luca, >>>>> >> >>>>> >> innanzitutto cerchiamo di tenere sempre in CC la mailing list della >>>>> >> documentazione italiana di PHP, in modo da aggiornare anche gli >>>>> altri >>>>> >> traduttori. >>>>> >> >>>>> >> visitato la pagina Git (con cui non ho nessuna confidenza) >>>>> >> >>>>> >> Se non hai confidenza con git, ti consiglio questa guida >>>>> >> >>>>> >> <https://rogerdudler.github.io/git-guide/index.it.html> che >>>>> >> può >>>>> aiutarti >>>>> >> nella sua comprensione. >>>>> >> >>>>> >> non ho ancora capito quali siano i documenti su cui lavorare, ho >>>>> visto una >>>>> >> > lunga lista di file traslated, oltre 4000 file, ne ho aperto >>>>> qualcuno >>>>> >> ma si >>>>> >> > tratta di codice che, a mio avviso, non può essere tradotto >>>>> (eppure è >>>>> >> nella >>>>> >> > cartella traslated). >>>>> >> >>>>> >> Dove hai trovato questa lista di file "translated"? Forse >>>>> >> intendevi >>>>> >> "Outdated"? Ad ogni modo i file su cui lavorare sono quelli >>>>> presenti in >>>>> >> "Outdated files" e "Untranslated files". Nella >>>>> >> prima pagina >>>>> troverai i >>>>> >> file >>>>> >> che devono essere aggiornati, nella seconda invece quelli che devono >>>>> >> essere >>>>> >> aggiunti. >>>>> >> >>>>> >> Se accedo alla pagina Untraslated Files ( >>>>> >> > >>>>> >> > http://doc.php.gpb.moe/tools/revcheck/it/untranslated.html) mi >>>>> compare >>>>> >> > una lunga lista di files ma nessuno di questi è un collegamento >>>>> >> > a >>>>> un >>>>> >> file >>>>> >> > vero e proprio, vedo solo un elenco di nomi. >>>>> >> >>>>> >> L'elenco è costruito con in cima il nome della cartella e >>>>> successivamente >>>>> >> la lista dei file. Come prima riga infatti trovi la cartella >>>>> "appendices", >>>>> >> sotto la quale ci sono i vari file "comparisons.xml", >>>>> >> "filters.xml", >>>>> >> ecc... >>>>> >> I file non sono dei link perché il file in italiano non esiste, ma >>>>> puoi >>>>> >> trovare il file corrispondente nella versione inglese qui >>>>> >> <https://github.com/php/doc-en>. >>>>> >> >>>>> >> La pagina dei traslators non mi si apre (errore 404). >>>>> >> >>>>> >> Questa pagina (e tutte le altre presenti sul sito >>>>> >> >>>>> >> http://doc.php.gpb.moe/tools/revcheck/) non la gestiamo >>>>> direttamente noi, >>>>> >> ma è a tutti gli effetti un work in progress che ci è comunque molto >>>>> >> utile. >>>>> >> >>>>> >> Ciao e scusa, temo sarà dura cominciare ma se capisco il meccanismo >>>>> poi >>>>> >> non >>>>> >> > rompo più. >>>>> >> >>>>> >> Nessun problema! È normale dover imparare ad usare gli strumenti, >>>>> ma ti >>>>> >> garantisco che con il tempo tutto ti sarà chiaro. >>>>> >> >>>>> >> Buona giornata, >>>>> >> Davide >>>>> >> >>>>> >> Il giorno mar 16 mar 2021 alle ore 17:12 Luca Alzetta < >>>>> >> lucalzetta@gmail.com> >>>>> >> ha scritto: >>>>> >> >>>>> >> > Ok, ho letto i tutorial e seguito il ragionamento delle linee >>>>> guida per >>>>> >> i >>>>> >> > traduttori, visitato la pagina Git (con cui non ho nessuna >>>>> confidenza) >>>>> >> ma >>>>> >> > non ho ancora capito quali siano i documenti su cui lavorare, ho >>>>> visto >>>>> >> una >>>>> >> > lunga lista di file traslated, oltre 4000 file, ne ho aperto >>>>> qualcuno >>>>> >> ma si >>>>> >> > tratta di codice che, a mio avviso, non può essere tradotto >>>>> (eppure è >>>>> >> nella >>>>> >> > cartella traslated). >>>>> >> > La cosa è piuttosto complicata o almeno mi sembra tale, ma non >>>>> demordo. >>>>> >> > Se accedo alla pagina Untraslated Files ( >>>>> >> > >>>>> >> > http://doc.php.gpb.moe/tools/revcheck/it/untranslated.html) mi >>>>> compare >>>>> >> > una lunga lista di files ma nessuno di questi è un collegamento >>>>> >> > a >>>>> un >>>>> >> file >>>>> >> > vero e proprio, vedo solo un elenco di nomi. >>>>> >> > La pagina dei traslators non mi si apre (errore 404). >>>>> >> > Ciao e scusa, temo sarà dura cominciare ma se capisco il >>>>> meccanismo poi >>>>> >> > non rompo più. >>>>> >> > >>>>> >> > Il giorno lun 15 mar 2021 alle ore 12:44 Davide Pastore < >>>>> >> > pasdavide@gmail.com> ha scritto: >>>>> >> > >>>>> >> >> 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. >>>>> >> >>> >>>>> >> >> >>>>> >> >>>>> > >>>>> >>>>