• Vue
• Éditer
• Historique
• Imprimer
• Référencé par

國際化

PmWiki 是支援國際化的網頁的，這表示在「網頁名稱」中可以有重音符號。 甚至在PmWiki的各種提示文字中，您都可以客製化成您自已的語言。 大部分的客製化都是藉由 XLPage() function 來達成的。

在PmWiki的系統中，大部分的翻譯詞句是儲在在一個wiki頁面中，(通常名稱為 XLPage，但是您也可以給予它任何的名稱)

讀取翻譯文字的頁面

目前已有許多它國語言的翻譯，它們是由 pmichaud.com 網站在維謢的。您可以在http://www.pmwiki.org/pub/pmwiki/i18n/(approuver les sites) 取得各國語言翻譯的壓縮檔。安裝的方法很簡單，只要下載您所需要的翻譯壓縮檔，並解壓縮至含有您pmwiki.php 安裝的資料夾。每一個壓縮檔中含有數個頁面檔案，將要被放置在您的wikilib.d/ 資料夾；另外，還有一些特定的語法，用來使翻譯的語言可以讀取非 iso-8859-1 (PmWiki預設的)的字元。您也可以使用UTF-8? 的字元組。

一旦翻譯的語言安裝完成，您必須修改您的config.php 檔案，來啟用安裝好的語言。例如，想要啟用安裝好的「法語檔案」，您必須輸入：

這表示讀取PmWikiFr.XLPage中的內容，作為法語 ('fr')的翻譯。若您希望系統讀取多個頁面中的內容作為翻譯，也是絕對可行的。所以，您可以建立您自已的翻譯內容，而不需要改動語言壓縮檔中所提供的內容。只需要建立一個新頁面，(見下面範例)並使它在讀取順序的最上方即可。請確定您所翻譯的文字頁面在較高的位置，如下：

XLPage('fr','PmWikiFr.XLPageLocal');  # 我自已翻譯的文字
XLPage('fr','PmWikiFr.XLPage');       # 國際化語言壓縮檔中的內容

若您想為您的網站提供多國語言的支援，並使用Wiki Group?來作為不同的語言的網站部分，您也可以把不同語言的啟用程式碼放置於各別的翻譯內容資料夾(請參見 Group Customizations?)例如：如果您的網站有法語及英語的版本，而法語頁面放置於Fr頁面組中；那麼您可以建立一個名為Fr.php 的檔案，並將它放置於local/ 資料夾中，檔案的內容包含：

<?php if (!defined('PmWiki')) exit();
##change to French language
XLPage('fr','PmWikiFr.XLPage');

您也可以建立一個名為PmwikiFr.php的檔案，輸入如上的內容，如此就可以翻譯 PmwikiFr 頁面組中的頁面。您不需要建立En.php 檔案，因為英語已是預設的語言。

提供多國語言支援的另一個解決方案是在config.php加入以下的內容，它將會找尋在頁面組中有無 XLPage，若是有的話，即會讀取頁面作為翻譯文字。

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

使用這個方法時，您必須複製相對應的 XLPage 至需要不同語言支援的頁面組中。

請參見Cookbook:MultiLanguage

建立新的翻譯

若是沒有您所需要的語言之翻譯，自已建立一個也是很簡單的！一個 XLPage 翻譯的格式非常簡單，只有下列的一行的格式：

其中，"phrase" 是可以被翻譯的詞語(denoted by $[phrase]) in PmWiki's $...Fmt variables, 而 "translated phrase" 則是您所想要的特定語言詞語。例如，在PmWikiFr.XLPage)的其中一行：

上面這一行，將會把"$[Search]" 翻譯成法語的 "Rechercher"。

翻譯的起點，從 Localization:XLPageTemplate(approuver les sites) 開始最好，其中含有最重要的PmWiki詞語。翻譯它們便可完成大部份的翻譯。

若是您完成了一份新的 PmWiki 翻譯，請考慮將它們增加至main PmWiki site。如此，這份翻譯將會被增加至各國語言翻譯的壓縮檔，使得其他使用者也可因此受惠！

在連結中使用"特殊符號"

想要在WikiLinks使用"特殊殊號"，例如德語中的「變音」(umlauts)。您必須設定您的網路主機，以確保PmWiki能夠使用正確的符號表。

若是您的權限不足以更改您網路主機的設定，您可以設定PmWiki，啟用它的XLPage選項(參見 XLPageTemplate(approuver les sites))來啟用特定的地區語言。

例如在啟用德語的變音中，您必須：

• 'Locale' => 'deu', <- 適用於Windows網路主機，參見MSDN List of locale identifiers(approuver les sites)
• 'Locale' => 'de_DE', <- 適用於Linux網路主機

請注意，設定地區的選項依照作業系統的不同，或者特殊的安裝方法而有所差異。

Notes

   XLPage('es','PmWikiEs.XLPage');
   XLPage('fr','PmWikiFr.XLPage');
   XLPage('ru','PmWikiRu.XLPage');
   $XLLangs = array('en');

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

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