Re: [DOC-IT] Re:

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