PmWiki supports internationalization of web pages, allowing accented characters to appear in page names and almost complete customization of PmWiki's prompts. Most customization is provided via the XLPage() function in PmWiki, which loads a set of translation variables from a wiki page (typically named XLPage, but it can be named anything you wish).
Loading translation pages
Pages for many languages such as French, German, Dutch, and Spanish have already been created and maintained at the pmichaud.com site. You can download an archive of these translations from
http://www.pmichaud.com/pub/pmwiki/i18n.tgz. Simply unpack the archive into the directory containing your
pmwiki.php installation. The 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 (PmWiki's default).
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
XLPage('fr','PmWikiFr.XLPage');
which says to load the translations for French ('fr') from the page
PmWikiFr.XLPage?. It's perfectly okay to load multiple pages; so if you want to create your own local translations without changing the ones you got from
i18n.tgz, just create another page (see below) and load it on top:
XLPage('fr','PmWikiFr.XLPage'); # from i18n.tgz
XLPage('fr','PmWikiFr.XLPageLocal'); # my local translations
Creating new translations
If language pages don't exist for your desired language, it's easy to create one! An XLPage translation file simply contains lines of the form
'phrase' => 'translated phrase',
where "phrase" is an internationalized phrase (denoted by
$[...]) in PmWiki's $...Fmt
variables, and "translated phrase" is what should be printed in your particular language. For example, the line (in PmWikiDe.XLPage)
'SearchWiki' => 'Suchen',
converts "SearchWiki" to "Suchen" on output. The file
PmWiki:XLPageTemplate is a good starting point for creating a new XLPage and has most of PmWiki's key phrases already listed in it. Note that the translation mechanism only converts phrases that have been listed as translatable in $...Fmt strings--it won't translate things that appear in wiki markup.
If you create new versions of PmWiki pages in other languages, please consider adding them to the
main PmWiki site [
http://www.pmwiki.org/wiki/PmWiki/PmWiki] so that they can be made available to others in the
i18n.tgz archive!
The term "i18n" is commonly used as an abbreviation for the English word "internationalization". The abbreviation is derived from the fact that there are 18 letters between the "i" and the final "n" and few people want to type them all out.
<< UploadsAdmin | PmWiki.DocumentationIndex | MailPosts >>