Pm Wiki supports internationalization (internationalisation) of web pages, allowing accented characters to appear in page names and almost complete customization of Pm Wiki's prompts. Most customization is provided via the XL Page?() function in Pm Wiki, which loads a set of translation variables from a wiki page (typically named XL Page?, but it can be named anything you wish).
The rest of this page is devoted to the installation, configuration and usage of other language(s) support. If you are looking for tools and help to localize Pm Wiki in your language, or how you can improve the existing translations, start on pmwiki.org with the page Localization - The Translation Portal.
Pages for many other languages have already been created and maintained at the pmichaud.com site. You can download an archive of these translations from http://www.pmwiki.org/pub/pmwiki/i18n/ . Simply download the appropriate language archive(s), and unpack the archive(s) into the directory containing your pmwiki.php installation. Each archive contains a number of page files that are placed in your wikilib.d/ directory, and some special scripts for translations that use a character set other than iso-8859-1 (Pm Wiki's default). You can also use UTF-8 charset.
Once the translation pages are installed, you enable a language by adding a call to XLPage() in your config.php file. For example, to select French language prompts, one would specify
include_once("scripts/xlpage-utf-8.php"); # optional XLPage('fr','PmWikiFr.XLPage');
which says to load the translations for French ('fr') from the page PmWikiFr.XLPage?. The include_once line is recommended if you start a new wiki, and it should be placed before the XL Page? line (for languages with alphabets other than the Latin, the include_once line is required). These lines should be placed near the beginning of config.php, but after any
$WikiLibDirs setting (if you have such setting).
It's possible to load multiple pages; so if you want to create your own local translations without changing the ones you got from an i18n archive, just create another page (see below) and load it first. Be sure that you load first the page with your local changes:
XLPage('fr','PmWikiFr.XLPageLocal'); # my local translations XLPage('fr','PmWikiFr.XLPage'); # from i18n.tgz
If your intention is to offer multiple languages on your site, and use Wiki Groups as language selectors, you may want to place this code in local customizations files (see Group Customizations). For example, if your site is published in French and English, and the French pages are in a group called Fr, you could create a file named Fr.php in the local/ directory which contains:
<?php if (!defined('PmWiki')) exit(); ##change to French language XLPage('fr','PmWikiFr.XLPage');
You may wish to create a page called Pmwiki Fr?.php with the same content to access the French documentation in the Pmwiki Fr? group. En.php is not necessary in this case since English is the default language.
$xlpage = FmtPageName('$Group.XLPage', $pagename); if (PageExists($xlpage)) XLPage($xlpage, $xlpage);
See also Cookbook:MultiLanguage
'phrase' => 'translated phrase',
where "phrase" is an internationalized phrase (denoted by
$[phrase]) in Pm Wiki's $...Fmt variables, and "translated phrase" is what should be printed in your particular language. For example, the line (in
'Search' => 'Rechercher',
If you create new versions of Pm Wiki pages in other languages, please consider adding them to the main PmWiki site so that they can be made available to others in the i18n archives! (Be sure to check out The Localization Portal? for further information on effectively internationalizing Pm Wiki.)
Enabling "Special" Characters in Wiki Links?
For German umlauts, you'd need for example:
'Locale' => 'deu',<- for Windows servers, see MSDN List of locale identifiers
'Locale' => 'de_DE',<- for Linux servers; for the UTF-8 encoding, on some installations you may need to set
Note that the locale identifier depends on the operation system and perhaps on the specific installation.
If my wiki is internationalized by config.php, how do I revert a specific group to English?
$XLLangs = array('en'); in the group's group customization file.
If my wiki is in English and I want just one page, or group, in Spanish do I say
XLPage('es','PmWikiEs.XLPage'); in the group or page configuration file?
Yes, that is usually the best method. If you were doing this with many scattered pages, or with several languages, you might find it easier to maintain if you load the translations all in config.php like this:
XL Page?('es','Pm Wiki Es.XL Page?'); XL Page?('fr','Pm Wiki Fr.XL Page?'); XL Page?('ru','Pm Wiki Ru.XL Page?');
Then in each group or page configuration file, you'd just use
$XLLangs = array('es'); to set the language to use (in this case, Spanish). Note that though this method is easier to maintain, its somewhat slower because it loads all the dictionaries for each page view, even if they won't be used.
What does the first parameter of this function stand for? How can it be used?
For example, suppose I want to have translations for both normal French and "Canadian" French. Rather than maintain two entirely separate sets of pages, I could do:
XL Page?('fr-ca', 'Pm Wiki Fr Ca.XL Page?'); XL Page?('fr', 'Pm Wiki Fr.XL Page?');
Pm Wiki Fr.XL Page? would contain all of the standard French translations, while Pm Wiki Fr CA.XL Page? would only need to contain "Canada-specific" translations -- i.e., those that are different from the ones in the French page.
The first parameter distinguishes the two sets of translations.
In addition, a config.php script can use the
to adjust the order of translation, so if there was a group or
page where I only wanted the standard French translation, I
$XLLangs= array('fr', 'en');
How can I add a translation for an individual string in a PHP file?
Use the XLSDV() function to provide a translation for a specific (English) string. For instance, with this in config.php
XLSDV('nl', array('my English expression'=>'mijn Nederlandse uitdrukking'));
any instance of the variable expression
$[my English expression] in wiki mark-up will be displayed as my English expression in default (English) context, but as mijn Nederlandse uitdrukking in Dutch (nl) context, i.e. when
XLPage('nl',...) has been called for that page in config.php or a cookbook recipe.
If you need to get a translation in a PHP file, use the
$local_string = XL("my English expression");
But beware: XL Page?() uses XLSDV() internally for its translation pairs, too, and only the first definition is accepted! Thus, if the Dutch XL Page? already contains a translation and you want to override that, you need to use your XLSDV('nl',...) before calling the correspondent XL Page?('nl',...). Otherwise, by using XLSDV() after XL Page?() - e.g. within a recipe that is included later in config.php - your translation will only work as long nobody defines 'my English expression' in that XL Page?.