• View
• Edit
• History
• Attach
• Print
• Backlinks

UTF-8

Description

A collection of UTF-8 related tips and fixes for PmWiki

• Please add your comments/questions about a section in the end of that section (to keep them together).
• Feel free to contribute with other tips or propose improvements to the existing ones.

How to enable UTF-8 support in PmWiki

Inside your (farm)config.php add the following line:

 include_once($FarmD.'/scripts/xlpage-utf-8.php');

It is recommended to enable UTF-8 for the entire site (as this encoding allows any language or alphabet to be used), and not for some Groups only (as in such case cross-group links may not work properly).

Internationalization and XLPage

Add in (farm)config.php:

 include_once($FarmD.'/scripts/xlpage-utf-8.php');
 XLPage('fr','Site.XLPage-fr');

See PmWiki.Internationalizations. Basically, you create an "XLPage" (eXtra Language page) containing the strings to translate (Edit - History - Print - Recent Changes - Search). You can use PmWiki.XLPageTemplate as a base for your translations. Copy this page, for example as Site.XLPage-fr, then fill in the translations.

You can use some ready translations from other PmWiki users, see PmWiki.OtherLanguages.

Note that you should first set the above lines in config.php, then open the selected page (in our example "Site.XLPage-fr") for editing, and paste there the translated page. Because: some currently available translations are in another encoding, ie. iso8859-1; if you just download the i18n.zip archive and copy the pages, some characters may not work.

To properly display the dates, numbers and other localized stuff, make sure you set in your Site/XLPage-fr the correct locale in .UTF-8, example:

 'Locale' => 'fr_FR.UTF-8',

Otherwise some of the accentuated letters may dissapear, i.e. for French: février. (On some systems it is not .UTF-8 but .utf8, try both.)

Broken {$Namespaced}, {$Titlespaced}, {$Groupspaced}

This was fixed in PmWiki version 2.2.0-beta30 (2007-02-09), but if you cannot upgrade, or wish to keep the latest stable version, take a look here:

• Cookbook.AsSpaced function in UTF-8

Using a different PageStore object (PerGroupSubDirectories...)

If you are using using an alternative page storing format/function/filename (examples: SQLite, PerGroupSubDirectories, CompressedPageStore), you must call the include_once($FarmD.'/scripts/xlpage-utf-8.php'); and XLPage() after the declaration of the alternative PageStore object (new PageStore() or include_once(recipe)).

Page names not properly resolved (pages dissapear, titles break...)

Any call to ResolvePageName() must be made after the include_once($FarmD.'/scripts/xlpage-utf-8.php'); and XLPage() calls. This function may be called by you in config.php and also by some recipe, so you should include any recipes after the include xlpage-utf-8.php and XLPage() call.

Order: In the best case, you should

1. first declare the PageStore object (or recipe that declares it),
2. next set internationalizations (xlpage-utf-8.php and XLPage()) and
3. then all other recipes.

This tip will save you days of headaches why your pages dissapear and titles break!!!

Other comments

UTF8 should be enabled when installing PmWiki, to avoid page content problems. This is not said in the install instructions AFAIK - jdd

If you have problems with your old pages written in other unicode after enabled utf-8, use the programm 'recoding' on Debian-Linux-Distributions to migrate the pages. Also for the i18n-Pakages from PmWiki.

See Also

Contributors