Re: preklad manualu k PHP

Jsme radi, ze pribyvaji zajemci o prekladani dokumentace :-) Spravcem 
jsem ja (asi se k tomu bude hlasit jeste Jakub Vrana), ale je to spis 
formalni zalezitost, aktivita v prekladu je v posledni dobe minimalni. 
Ani ja na to nemam cas, takze jen sem tam neco prelozim.
Postup je nasledujici:
1. Pres formular na http://www.php.net/cvs-php.php si vyzadat pristup do 
CVS archivu (k pristupu se davala i adresa [email protected], asi to stale 
jeste plati)
2. Prihlasit se k CVS serveru (melo by stacit jen jednou: cvs -d 
:pserver:[email protected]:/repository login).
2. Pred prekladem si vzdy stahnout si prislusnou cast CVS stromu pro 
ceskou dokumentaci (cvs -z3 -d :pserver:[email protected]:/repository co 
phpdoc-cs)
3. Prekladaji se jednotlive soubory - je to v XML, kodovani ISO-8859-2, 
konce radku jsou LF a misto tabulatoru se maji pouzivat mezery. 
Prelozene soubory se ukladaji ve strome pod adresarem "cs", dosud 
neprelozene jsou pod adresarem "en".
4. Po prelozeni se vlozi soubory na archiv (update + commit, nove 
soubory pomoci add - viz dokumentace k CVS)
5. Koordinace se provadi pres soubor cs/translation.xml - tam se kazdy 
aktivni prekladatel prida a mel by tam vzdy uvest soubory, na kterych 
prave pracuje. Bohuzel se to moc nepouziva, ale melo by to zabranit 
praci navic.
6. Pred vlozenim na archiv by kazdy spravne mel otestovat, zda lze 
manual sestavit - osobne to nedelam, je to dost casove narocne. Je ale 
potreba si dat dusledne pozor aspon na to, aby XML soubory byly 
"well-formed", tj. zpracovatelne parserem. Jediny vadny soubor zabrani 
sestaveni cele dokumentace!!!
7. Dokumentace se na serverech sestavuje automaticky jednou za cas (ted 
asi 1x za 14 dní), takze tam byva zpozdeni.
8. Kazdy prekladany soubor by mel obsahovat hlavicku s odkazem na 
puvodni revizi, se jmenem spravce souboru a stavem prekladu (priklad: 
<!-- EN-Revision: 1.11 Maintainer: luk Status: ready -->). Stav je bud 
"ready" = uplne prelozeno, nebo "mixed" = castecne prelozeno. Viz 
prelozene soubory.
9. Co se tyka pridelovani, nic se direktivne neprideluje. Ale existuje 
tu par zasad:
a. Kazdy, kdo se pusti do prekladu noveho souboru, se stava jeho 
spravcem a mel by se snazit ho nadale udrzovat synchronizovany s originalem.
b. Na soubory, ktere aktualne nekdo preklada (viz translation.xml) se 
nesaha.
c. Kdo najde chybu v cizim prekladu (nebo i v originale) a je si jisty, 
ze je to chyba, mel by ji co nejdriv opravit. Pokud si chybou jisty neni 
nebo se jedna o prave prekladany soubor, mel by uvedomit spravce souboru.
d. Nektere soubory se nesmi prekladat - byva to v nich (nebo jinde) napsano.
e. Prioritu ma prekladani ucelenych casti, tj. kdo zacina, mel by si 
vybrat neco, na co jeste nebylo sahnuto.
f. Absolutně prioritni je synchronizace zakladnich souboru primo v 
adresari "cs" (language-defs.xml, language-snippets.xml atd.), bez toho 
nemusi jit sestavit dokumentace. Snazim se synchronizaci zajistit, ale 
obcas to nestiham, takze to muze udelat kdokoliv.
10. Dalsi pravidla a pokyny jsou na 
http://cz.php.net/manual/howto/index.html

Mozna to vypada slozite, ale je to jednoduche, kdyztak muze poradit i 
Jakub Vrana, Gabor Hojtsy nebo nektery jiny zkuseny prekladatel PHP. 
Preju hodne uspechu pri prekladani dokumentace!

Lukas Jelinek
[email protected]


>Ahoj,
>myslim, ze bych mohl prelozit nejake casti manualu. Jakym zpusobem mam postupovat? (Kdo je spravcem a prideluje jednotlive casti prekladatelum, nebo jak to funguje?)
>
>Diky
>
>camlost
>
>
>  
>