A PmWiki könnyen adaptálható bármelyik nyelvre: mind a szócikkek tartalma, mind a PmWiki felülete könnyen adaptálható. Az adaptáció legnagyobb része az PmWikiHu.XLPage oldalon keresztül történik.
A lefordított oldalak letöltése
A PmWiki számos nyelvre, köztük magyarra is le van fordítva. A szükséges fájlokat a http://www.pmichaud.com/pub/pmwiki/i18n.tgz állományban találhatod. Az archívban kétféle fájl van:
- Karakterkódolást tartalmazó php szkriptek.
- Lefordított standard oldalak. (Sajnos a dokumentáció nincs teljeskören lefordítva. Segítséget elfogadunk!)
Ezeket a fájlokat egyszeren be kell másolni a pmwikit tartalmazó könyvtárakba. (Ügyelj rá, hogy minden fájl a megfelel célkönyvtárba kerüljön!)
Ha a fájlokat telepítetted, módosítanod kell a config.php fájlt. A magyar nyelv hozzáadásához pl. a következt kell begépelned:
XLPage('hu','PmWikiHu.XLPage');
Egyszerbb esetben ezzel le is záródik a nyelvi adaptáció.
A fordítás módosítása
Elfordulhat, hogy a fenti adaptáció után sem tökéletes a nyelvi adaptáció:
- Bizonyos szövegek hiányozhatnak.
- Bizonyos fordítások tévesek lehetnek.
- Elfordulhat, hogy nem tudsz ékezetes bett használni a szócikkek címében.
Ilyenkor az XLPage nev oldalt kell módosítanod.
Hiányzó fordítások pótlása
Els lépésként meg kell keresned az XLPage oldalt. Ez normális esetben valami hasonló url alatt van:
http://www.a-te-oldalad.hu/pmwiki.php/PmWikiHu/XLPage
Az XLPage egy teljesen normális PmWiki oldal, amit weben keresztül szerkeszthetsz. A hiányzó szövegeket a következ formában adhatod meg:
'angol eredeti' => 'magyar megfelel',
Bizonyos szövegekben változókat találsz. Ezeket változatlan formában vedd át, mert a változó csak akkor változik, ha a neve nem változik. :-)
Fordítások javítása
A fordítások javításának a legegyszerbb módja, ha az imént említett módon megváltoztatod az XLPage tartalmát. Kicsit elegánsabb, ha egy másodlagos fordító oldalt is létrehozol pl. XLPageLocal néven, és abban felüldefiniálod a neked nem tetsz fordításokat. Ebben az esetben a config.php fájlt is módosítanod kell, mégpedig így:
XLPage('hu','PmWikiHu.XLPageLocal'); # az én fordításaim
XLPage('hu','PmWikiHu.XLPage'); # eredetik az i18n.tgz-bl
Ennek a megközelítésnek az az elnye, hogy egy esetleges upgrade-nél gondolkozás nélkül felülírhatod a "hivatalos" XLPage fájl a frissített verzióval.
Problémák az ékezetes oldalnevekkel
Bizonyos esetekben elfordulhat, hogy nem tudsz ékezetes oldalneveket alkalmazni, vagy azok megbízhatatlanul jelennek meg. Ugyanakkor a szócikkek tartalma minden magyar ékezetet tartalmaz, és azok rendesen meg is jelennek. Ha ezt tapasztalod, minden bizonnyal a karakterkódolással van probléma.
Az XLPage fájl els sorainak egyikében döntened kell arról, hogy milyen karakterkódolást akarsz az oldalaidon használni. A PmWiki alap karakterkészlete, az Wikipedia:ISO-8859-1 nem ismeri a hosszú és betket, ezért ezeket a pmwiki alapesetben átkódolja. Ezt elkerlend, két karakterkészlet közül választhatsz:
Az ISO-8859-2 mellett szól, hogy ezt a régebbi böngészk is helyesen kezelik, és hogy a PmWiki magyar dokumentációja ebben íródott. A Unicode viszont egy sokkal teljeskörbb szabvány, amely minden nyelvet támogat; hosszabb távon pedig minden, magára valamit is adó szoftvernek támogatnia illik.
A kiválasztott karakterkészletet az XLPage oldalon definiálhatod:
'xlpage-i18n' => 'iso-8859-2'
- vagy -
'xlpage-i18n' => 'utf-8'
Fontos megjegyezni, hogy ha váltassz a kett között, akkor az ékezetek mindenhol - oldal címében és tartalmában - olvashatatlanná válnak, és csak kézi munkával állíthatóak vissza. Az átállítás technikailag sem problémamentes, mert bizonyos böngészk (IE6) nem képesek a helytelenül kódolt oldalak megjelenítésére.
