PmWiki podporuje internacionalizaci webových stránek, umo¾òuje aby se v názvech stránek nacházeli znaky s diakritikou a témìø zcela lokálnì pøizpùsobilo systémové hlá¹ení PmWiki. Vìt¹ina tìchto pøizpùsobení se v PmWiki vyøe¹í funkcí XLPage(), která naèítá sadu pøekladových promìnných z wiki stránky (typicky pomenované XLPage, ale mù¾e se jmenovat i jinak).

Naèítání stránek s pøekladem

Stránky pro mnohé jazyky jako francouz¹tina, nìmèina, holadn¹tina a ¹panìl¹tina u¾ jsou vytvoøené a udr¾ované na webové stránce pmichaud.com. Archiv tìchto pøekladù si mù¾ete stáhnout z http://pmichaud.com/pub/pmwiki/i18n/ (a vyberte si èeský balíèek, má ve jménì cs). Jednodu¹e rozbalte archiv do adresáøe obsahujícího va¹i instalaci pmwiki.php. Archiv obsahuje mno¾ství souborù stránek, které jsou umístìny ve va¹em adresáøiwikilib.d/, a nìkteré speciální skripty pro pøeklady,, které pou¾ívají jinou znakovou sadu ne¾ iso-8859-1 (výchozí kódování PmWiki).

Kdy¾ jsou stránky s pøeklady nainstalované (tj. nakopírované), jazyk zapnete pøidání volání XLPage() do svého souboru config.php. Napøíklad, pro volbu francouzských hlá¹ení bychom uvedli

co¾ udává, ¾e je tøeba naèítat pøeklady pro francouz¹tinu ('fr') ze stránky PmWikiFr.XLPage. Pro èeský pøeklad pou¾ijete:

 Je zcela v poøádku naèítat nìkolik stránek; tak¾e pokud chcete vytvoøit vlastní lokální pøeklady beze zmìn tìch získaných z i18n.tgz, vytvoøte pouze dal¹í stránku (viz ní¾e) a naèítejte ji nejprve. Ujistìte se, ¾e nejprve naèítáte stránku s va¹imi ístními zmìnami!!:

XLPage('fr','PmWikiFr.XLPageLocal');  # moje osobní pøeklady
XLPage('fr','PmWikiFr.XLPage');       # z i18n.tgz

Pokud máte v úmyslu provozovat svoje webové stránky ve více jazycích a pou¾ívat (Wiki skupiny?) jako selektory jazykù, budete chtít pravdìpodobnì umístit tento kód do souborù s lokálními úpravami (viz Nastavení pro skupiny?). Napøíklad, pokud je va¹e stránka dostupná francouzsky a anglicky a francouzské stránky jsou ve skupinì pojmenované Fr, vytvoøili byste soubor pojmenovaný Fr.php v adresáøi local/ který by obsahoval:

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

Mù¾ete chtít vytvoøit stránku nazvanou PmwikiFr.php se stejným obsahem pro pøístup k francouzské dokumentaci ve skupinì PmwikiFr. En.php v tomto pøípade není potøeba, nebo» angliètina je výchozí pøedvolený jazyk.

Alternativa k vý¹e uvedenému by bylo pøidat do config.php následující kód, který testuje zda ve skupinì existuje XLPage, a pokud ji najde, naèítá ji:

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

S touto metodou doká¾ete pøiøadit pøíslu¹nou XLPage do jakékoli skupiny, která potøebuje jinou jazykovou podporu.

Tvorba nových pøekladù

Pokud pro vámi po¾adovaný jazyk neexistují stránky jazyka, ke lehké je vytvoøit! Pøekldaový soubor XLPage obsahuje øádky ve tvaru

kde "výraz" je internacionalizovaný výraz (oznaèený pomocí $[výraz]) v $...Fmt promìnných PmWiki, a "pøelo¾ený výraz" je to, co by se mìlo zobrazit ve va¹em konkrétním jazyce. Napøíklad, øádek (v PmWikiFr.XLPage)

pøevede na výstupu "$[SearchWiki]" na "Rechercher". Soubor PmWiki:XLPageTemplate je dobrý výchozí bod pro tvorbu nové stránky XLPage a ji¾ v sobì obsahuje vìt¹inu klíèových výrazù PmWiki. V¹imnìte si, ¾e pøekladový mechanismus pøevádí jen výrazy, které jsou uvedené jako pøelo¾itelné v øetìzcích $...Fmt --nepøelo¾í normální text ve formátovaní wiki.

Pokud vytvoøíte nové verze stránek PmWiki v jiných jazycích, prosím uva¾ujte o jejich pøidání na hlavní stránku PmWiki tak aby byli pøístupné ostatním v archívu i18n.tgz!

Nástroje pro lokalizaci PmWiki

Mù¾ete pomoci lokalizovat PmWiki do svého jazyka na pùvodní stránce:

• PmWiki:Localization

<< Vlastní WikiStyly | Index dokumentace | Lokální nastavení? >>

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

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