Re: [DOC-IT] Re:

[email protected] (Massimiliano Arione) Mon, 22 Mar 2021 07:43:30 +0100
Newsgroups php.doc.it
Message-ID <CAHxDSyhr35W=1aNvrzkX-_mVQAKLiv=sdzXw82t6qTubgj6vEw@mail.gmail.com>
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.
> >> >>>
> >> >>
> >>
> >
>