Reguli generale la traducere
| From: | Simion Onea | Date: | Wed, 19 Mar 2008 12:31:05 +0000 |
| Subject: | Reguli generale la traducere | ||
| Groups: | php.doc.ro | ||
| Request: | Send a blank email to doc-ro+get-354@lists.php.net to get a copy of this message | ||
Alexandru, aş vrea să menţionez unele aspecte în privinţa traducerii. Posibil că pe unele le
cunoşti deja.
a) Codificarea -- utf-8
E de dorit să stabilim codificarea caracterelor (encoding) în fişierele traduse în
"utf-8".
Pentru aceasta trebuie să ai un editor care îţi permite să lucrezi cu fişiere XML cu
codificarea utf-8.
Când începi traducerea unui fişier modifici primul rând din
<?xml version="1.0" encoding="iso-8859-1"?>
în
<?xml version="1.0" encoding="utf-8"?>
şi salvezi fişierul.
Mai departe poţi să utilizezi caracterele diacritice româneşti.
(În Dreamweaver eu trebuie să închid şi apoi să deschid fişierul după ce schimb codificarea
caracterelor pentru ca totul să funcţioneze normal)
b) Sfârşitul liniei.
La fişierele textuale există trei tipuri de sfârşit de linie:
- Windows -- CR+LF
- Unix -- LF
- Mac -- CR
În fişierele manualului se utilizează sfârşiturile de linii de tip Unix.
Iarăşi, editorul trebuie să susţină lucrul cu astfel de sfârşituri de linie şi să nu le
transforme în "CR+LF".
c) Ce nu se traduce.
Nu se traduc denumirile tag-urilor şi atributele lor.
Nu se traduc elementele predeclarate, cum ar fi &null; &false;, etc.
În privinţa tipurilor nu am convenit definitiv, dar se pare că este mai bine de a nu le traduce
(adică "array" rămâne "array", "string" -- "string",
etc.)
Nu se traduc denumirile funcţiilor, claselor de obiecte, etc.
d) Deplasamentul textului.
Se are în vedere "indentation".
Blocurile în XML se "indent-ează" cu un spaţiu. Caractere "tab" NU sunt
admise.
Ai grijă, te rog, ca editorul tău să nu transforme automat 8 spaţii într-un "tab".
e) Lungimea liniei.
Trebuie să ne străduim ca linia să nu depăşească 78-79 caractere. Ce e mai mult, se trece din
rând nou.
Ei bine, sunt cazuri când nu e posibil de respectat strict această regulă, dar e de dorit să fie
cât mai rar aşa situaţii.
f) Dicţionar.
Pentru a păstra "consistenţa" traducerii anumitor termeni des întâlniţi în manual am
hotărât să creez un dicţionar special.
Poţi descărca pe disc fişierele
http://cvs.php.net/viewvc.cgi/phpdoc-ro/dictionary.xml?content-type=text%2Fplain&view=co
http://cvs.php.net/viewvc.cgi/phpdoc-ro/dictionary.xsl?content-type=text%2Fplain&view=co
şi apoi să încarci în browser "dictionary.xml" pentru a vizualiza dicţionarul.
Cam aceasta e tot. Dacă îmi voi mai aminti ceva, îţi voi scrie.