Re: [DOC-IT] Re:

[email protected] (Luca Alzetta) Sun, 21 Mar 2021 00:47:07 +0100
Newsgroups php.doc.it
Message-ID <CAFTdZUBeqBDdO_8HJj2iV9fw1DW41TZyAX5Z=5M1RZvhTWqydQ@mail.gmail.com>
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.
>> >>>
>> >>
>>
>