Re: [DOC-IT] 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 <[email protected]>
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 <
> [email protected]> 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 <
>> [email protected]> 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 <
>>> [email protected]> 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 <
>>>> [email protected]> 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 <
>>>>> [email protected]>
>>>>> 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 <
>>>>> > [email protected]> 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 <
>>>>> >> [email protected]>
>>>>> >> 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 <
>>>>> >> > [email protected]> 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 [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.
>>>>> >> >>>
>>>>> >> >>
>>>>> >>
>>>>> >
>>>>>
>>>>