Internacionalizácia

PmWiki podporuje internacionalizáciu webových stránok, umož?ujúc aby sa v názvoch stránok nachádzali znaky s diakritikou a takmer úplné prispôsobenie hlásení PmWiki. Vä?šina prispôsobenia sa v PmWiki robí pomocou funkcie XLPage(), ktorá na?íta sadu prekladových premenných z wiki stránky (typicky pomenovanej XLPage, ale môže by? pomenovaná ako len chcete).

Na?ítanie stránok s prekladom

Stránky pre mnohé jazyky ako francúzština, nem?ina, holand?ina a španiel?ina už boli vytvorené a udržiavané na webovej stránke pmichaud.com. Archív týchto prekladov si môžete stiahnu? z http://www.pmichaud.com/pub/pmwiki/i18n.tgz. Jednoducho rozba?te archív do adresára obsahujúceho vašu inštaláciu pmwiki.php. Archív obsahuje množstvo súborov stránok, ktoré sú umiestnené vo vašom adresári wikilib.d/, a niektoré špeciálne skripty pre preklady, ktoré používajú inú znakovú sadu ako iso-8859-1 (predvolená hodnota PmWiki).

Ke? sú už stránky s prekladmi nainštalované, jazyk zapnete pridaním volania XLPage() do svojho súboru config.php. Napríklad, pre výber hlásení vo francúzskom jazyku, by sme uviedli

?o hovorí, že treba na?íta? preklady pre francúzštinu ('fr') zo stránky PmWikiFr.XLPage. Je úplne v poriadku na?íta? nieko?ko stránok; takže ak chcete vytvori? svoje vlastné lokálne preklady bez zmeny tých, ktoré ste dostali z i18n.tgz, iba vytvorte ?alšiu stránku (pozri nižšie) a na?ítajte ju navrchu. Uistite sa, že najprv na?ítate stránku s vašimi miestnymi zmenami:

XLPage('fr','PmWikiFr.XLPageLocal');  # moje osobne preklady
XLPage('fr','PmWikiFr.XLPage');       # z i18n.tgz

Ak máte v úmysle ponúka? na svojej webovej stránke viacero jazykov, a používa? (Wiki skupiny?) ako selektory jazykov, možno budete chcie? umiestni? tento kód do súborov s lokálnymi úpravami (pozri Nastavenia pre skupiny?). Napríklad, ak je vaša stránka uverejnená vo francúzštine a angli?tine, a francúzske stránky sú v skupine pomenovanej Fr, vytvorili by ste súbor pomenovaný Fr.php v adresári local/ ktorý obsahuje:

<?php if (!defined('PmWiki')) exit();
##zmena do francuzskeho jayzka
XLPage('fr','PmWikiFr.XLPage');

Môžete chcie? vytvori? stránku nazvanú PmwikiFr.php s rovnakým obsahom pre prístup k francúzskej dokumentácii v skupine PmwikiFr. En.php v tomto prípade nie je potrebný ke?že angli?tina je predvolený jazyk.

Alternatíva k vyššie uvedenému by bola prida? do config.php nasledujúci kód, ktorý testuje ?i v skupine existuje XLPage, a ak ju nájde na?íta ju:

    
$xlpage = FmtPageName('$Group.XLPage', $pagename);
if (PageExists($xlpage)) XLPage($xlpage, $xlpage);

S touto metódou by ste potrebovali skopírova? akúko?vek príslušnú XLPage do akejko?vek skupiny, ktorá potrebuje inú jazykovú podporu.

Tvorba nových prekladov

Ak pre váš požadovaný jazyk neexistujú stránky jazyka, je ?ahké ich vytvori?! Prekladový súbor XLPage jednoducho obsahuje riadky v tvare

kde "výraz" je internacionalizovaný výraz (ozna?ený pomocou $[výraz]) v $...Fmt premenných PmWiki, a "preložený výraz" je to ?o by sa malo zobrazi? vo vašom konkrétnom jazyku. Napríklad, riadok (v PmWikiFr.XLPage)

prevedie na výstupe "$[SearchWiki]" na "Rechercher". Súbor PmWiki:XLPageTemplate je dobrý za?iato?ný bod pre tvorbu novej stránky XLPage a už v sebe obsahuje vä?šinu k?ú?ových výrazov PmWiki. Všimnite si, že prekladový mechanizmus prevádza iba výrazy, ktoré boli uvedené ako preložite?né v re?azcoch $...Fmt --nepreloží normálny text vo formátovaní wiki.

Ak vytvoríte nové verzie stránok PmWiki v iných jazykoch, prosím uvažujte o ich pridaní na hlavnú stránku PmWiki tak aby boli sprístupnené ostatným v archíve i18n.tgz!

Nástroje pre lokalizáciu PmWiki

Môžete pomôc? lokalizova? PmWiki do svojho jazyka na pôvodnej stránke:

• PmWiki:Localization

<< Správa nahrávaní | Index dokumentácie | Wiki farmy >>

    XLPage('fr', 'PmWikiFr.XLPage');
    XLPage('fr-ca', 'PmWikiFrCa.XLPage');

    $XLLangs = array('fr', 'en');