Re: [DOC-IT] Re:

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