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 Localization: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:

• Localization.Localization

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

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

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