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