Re: [DOC-IT] Re:

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.
>>>> >> >>>
>>>> >> >>
>>>> >>
>>>> >
>>>>
>>>