Urmărirea versiunilor fişierelor
| From: | Simion Onea | 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.