Re: 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> 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 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 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> > Inviato: domenica 27 novembre 2016 14.04.06 > A: Sven Holmgren > Cc: 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>> > 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 > >