Re: Il primo commit
| From: | Davide Pastore | Date: | Sun, 27 Nov 2016 13:04:06 +0000 |
| Subject: | Re: Il primo commit | ||
| References: | 1 | Groups: | php.doc.it |
| Request: | Send a blank email to doc-it+get-2071@lists.php.net to get a copy of this message | ||
Ciao Sven,
ti chiedo scusa per il ritardo nella risposta ma durante questa settimana
sono stato molto impegnato. Ho fatto un UPDATE dei file da SVN ma non è
uscito fuori il tuo commit nei log. Forse non lo hai fatto effettivamente?
Prima di effettuare un commit e verificare che tutto stia apposto, puoi
eseguire un comando che ti aiuterà a capire se la creazione del manuale
avviene ancora correttamente, o se ci sono errori. Portati nella cartella
*doc-base* (che avrai scaricato in fase di checkout del progetto) ed esegui
il comando:
*php configure.php --with-lang=it*
Questo comando farà il build della documentazione italiana (dovrai
pazientare qualche minuto) e ti dirà se ci sono errori oppure se tutto
quello che hai modificato è corretto e consistente con la versione inglese.
Se vedrai questo messaggio vuol dire che tutto è apposto: *All good. Saving
.manual.xml... done.*
Questo comando viene utilizzato dal server PHP, che ogni x ore (forse 4)
effettua la build e manda una mail alla mailing-list della documentazione
la cui build risulta rotta. In alcuni casi può succedere che un errore
possa sorgere anche senza toccare nessun file della versione italiana, ma
modificando un file della versione inglese che elimina qualcosa di
obsoleto, presente ancora nella nostra versione.
Per quanto riguarda il file "it/chapters/intro.xml" c'era una piccola
modifica di punteggiatura (":" al posto del ".") che andrebbe comunque
riportata.
Ora che hai tutto sulla tua macchina, puoi utilizzare un'utility che ti
viene fornita per generare un file .html, che contiene tutto ciò che va
aggiornato (e non solo). Per generare questo file, è necessario eseguire il
seguente comando, portandoti nella cartella che contiene le directory
*doc-base*, *en* e *it*:
*php doc-base\scripts\revcheck.php it > lista.html*
Aprendo il file "lista.html" e cliccando su "[NoWS]" presente accanto al
nome del file, potrai vedere le differenze che ci sono tra la versione
italiana e quella inglese, in modo da capire cosa aggiungere, modificare o
eliminare.
Resto a disposizione per qualsiasi problema.
Buona giornata,
Davide Pastore
Il giorno 22 novembre 2016 08:38, Sven Holmgren <
svenholmgrenwallin@outlook.com> ha scritto:
> Buongiorno Davide,
>
>
> Ho aggiornato qualche file nella sezione "need update" e fra poco darò
> l'OK per il commit. A dire il vero sono un po' indeciso, ho paura di fare
> danni, dunque aggiorno questi due e poi aspetto una tua risposta per essere
> sicuro di non avere combinato malanni, modificherò i file
> "it/appendices/aliases.xml" e "it/chapters/intro.xml", l'ultimo in
> particolare non ha richiesto cambiamenti nel testo del file ma sono
> l'aggiornamento del numero di revisione.
>
>
> Ti auguro una buona giornata,
>
> sven
>