Re: [DOC-IT] Re:

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