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, nemina, holandina a španielina 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 rozbate 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 niekoko 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 anglitine, 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 anglitina 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úkovek príslušnú XLPage do akejkovek 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 (oznaený 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ý zaiatoný 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žitené v reazcoch $...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');