Re: Re: Il primo commit

Ciao Davide, perdona l'assenza, domandina veloce: se utilizzo Linux quale svn potrei utilizzare? ________________________________ Da: Davide Pastore <pasdavide@gmail.com> Inviato: lunedì 28 novembre 2016 12.08.51 A: Sven Holmgren Cc: doc-it@lists.php.net Oggetto: Re: [DOC-IT] Re: Il primo commit Ciao Sven, al posto di utilizzare l'editor online ti consiglio di usare un client SVN (tipo TortoiseSVN<https://tortoisesvn.net/> se sei su Windows) e di effettuare il checkout da https://svn.php.net/repository/phpdoc/modules/doc-it (questi passaggi sono indicati qui<http://doc.php.net/tutorial/structure.php>).. A questo punto modifichi i tuoi file, verifichi che la build vada bene e fai il commit delle tue modifiche inserendo un commento esplicativo (prova a vedere lo storico dei log per degli esempi). L'editor online purtroppo permette di committare le modifiche solo all'amministratore della documentazione e non a tutti gli utenti che ne fanno parte.. Tempo fa, per validare alcune revisioni che erano state proposte, dovetti richiedere il privilegio per farlo e fui accontentato. La chiave SSH credo che non sia obbligatoria, anche se attesta e conferma la tua identità nelle varie operazioni che farai. Resto a disposizione per chiarimenti. Buona giornata, Davide Pastore Il giorno 28 novembre 2016 11:39, Sven Holmgren <svenholmgrenwallin@outlook..com<mailto:svenholmgrenwallin@outlook.com>> ha scritto: Ciao Davide, purtroppo ho avuto un problemino durante il commit: non ho trovato l'opzione. Se devo essere sincero credo di aver ignorato qualche passaggio troppo importante, perchè al momento, i privilegi che ho accedendo con il mio account php.net<http://php.net> all'editor online, sono gli stessi. Tu hai parlato della cartella doc-base che dovrò aver già scaricato e qui mi sorge il dubbio. Dunque ti chiedo se gentilmente potresti rispiegarmi cosa devo fare per modificare autonomamente i file del repository. Al momento, dopo aver letto tutte le documentazioni che sono riuscito a trovare sul sito, ciò che ho capito è che con un account php.net<http://php.net> avrei potuto tradurre autonomamente operando dall'editor online. Nella mail di conferma registrazione account mi chiedono la chiave SSH, c'entra qualcosa? è necessaria? Per quanto riguarda il file "it/chapters/intro.xml" c'era la modifica della punteggiatura che ho trovato essere già stata eseguita, dunque mi sono limitato ad aggiornare il numero di revisione e aggiungere la solita riga <!-- $Revision$ -->. Spero di avere presto tue notizie in quanto sono un po' confuso e per questo i lavori sono fermi da qualche settimana. Ti auguro una buona giornata! Sven ________________________________ Da: Davide Pastore <pasdavide@gmail.com<mailto:pasdavide@gmail.com>> Inviato: domenica 27 novembre 2016 14.04.06<tel:2016%2014.04.06> A: Sven Holmgren Cc: doc-it@lists.php.net<mailto:doc-it@lists.php.net> Oggetto: Re: Il primo commit 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<mailto:svenholmgrenwallin@outlook.com><mailto:svenholmgrenwallin@outlook.com<mailto: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