Urmărirea versiunilor fişierelor

From: Date: Fri, 29 Jun 2007 08:13:04 +0000
Subject: Urmărirea versiunilor fişierelor
Groups: php.doc.ro 
Request: Send a blank email to doc-ro+get-237@lists.php.net to get a copy of this message
Salut tuturor! Aş dori să-mi expun câteva idei despre modul cum am putea urmări schimbările fişierelor engleze şi să le putem sincroniza pe cele româneşti. Am studiat capitolul "Revision Tracking" din "Documentation Howto" http://doc.php.net/php/dochowto/translation-revtrack.php . Acolo sunt descrise două metode de urmărire a schimbărilor. Prima metodă -- cu fişierul "Translators" -- a fost bună când erau puţine fişiere în manual, dar acum, ele fiind 7210, este foarte dificil de a menţine un tabel enorm cu lista tuturor fişierelor şi de a căuta unde sunt necesare schimbări. A doua metodă -- comentariile "EN-Revision:" adăugate în fiecare fişier -- este mult mai potrivită în acest caz, deoarece au fost create script-uri care automatizează colectarea acestor comentarii din toate fişierele. Pentru a beneficia de această metodă este suficient ca la fiecare fişier tradus, în a treia linie de a insera următoarele: <!-- EN-Revision: 1.16 Maintainer: jane Status: ready --> În loc de "1.16" se pune versiunea (revision) fişierului englez, care a fost tradus la moment. În loc de "jane" se pune respectiv "simionea", "radical" sau "zamolxe". Câmpul "Status" este un câmp informaţional şi nu este folosit la procesare. Se poate de scris "working", "ready", "translated" sau altceva la discreţia autorului. Pentru a vedea dacă un careva fişier tradus este "proaspăt", sau actualizat este suficient de a-l deschide şi de a vedea valoarea câmpului "EN-Revision". Dacă aceasta coincide cu valoarea câmpului "Revision" din fişierul englez respectiv, înseamnă că fişierul tradus este actual. Dacă valorile nu coincid, înseamnă că fişierul tradus este învechit. Atunci trebuie de întreprins următoarele: 1. De aflat care sunt diferenţele care au apărut în fişierul englez în versiunea nouă (să presupunem 1.17) faţă de versiunea tradusă 1.16 . Aceasta poate fi realizat pe pagina http://cvs.php.net/viewvc.cgi/phpdoc/en/ sau cu ajutorul comenzii "cvs diff". 2. De actualizat fişierul românesc în concordanţă cu diferenţele, pe care le-am găsit. 3. În fişierul românesc de schimbat "EN-Revision" în versiunea nouă (de ex. 1.17) 4. De efectuat "cvs commit" al fişierului tradus. Astfel fişierul tradus este "reîmprospătat". Pentru a nu verifica permanent versiunile tuturor fişierelor, a fost creat scriptul "scripts/revcheck.php". (Rulează în Linux; în Windows nu am verificat) Informaţia se prezintă foarte clar. Se poate de urmărit câte fişiere au fost traduse de fiecare traducător, câte din ele necesită reînnoire, este prezentă lista lor şi multe alte informaţii utile. Deoarece eu am utilizat la fişierele mele traduse "EN-Revision", informaţia despre acestea a fost preluată de script! Acest fişier ar trebui, de fapt, să se genereze automat în fiecare noapte pe serverul http://doc.php.net/php/ro/revcheck.php , însă aceasta nu are loc. Acolo informaţia este învechită. Urmărind discuţiile din lista "phpdoc@lists.php.net" am înţeles că asupra sistemului de generare automată se lucrează în prezent şi că va fi pus la punct în timpul apropiat. Concluzie: ~~~~~~~~~~ Vă propun să adoptăm acest sistem de urmărire a versiunilor fişierelor şi fiecare să adăugăm "EN-Revision" la fişierele sale. Va fi mai uşor de lucrat în acest mod. http://doc.php.net/php/dochowto/translation-revtrack.php Aştept opiniile voastre. Simion.

« previous php.doc.ro (#237) next »