blob: eb11b9a4b67fb8619b8c40918222923a85dc4d87 [file] [log] [blame]
text=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 site. You can download an archive of these translations from 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² =]²If your intention is to offer multiple languages on your site, and use WikiGroups as language selectors, you may want to place this code in local customizations files (see PerGroupCustomizations). 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 `PmwikiFr.php with the same content to access the French documentation in the `PmwikiFr group.²En.php is not necessary in this case since English is the default language.²²An alternative to the above would be to add to config.php the following, which tests if there is an `XLPage in a group, and if it finds one it gets loaded [= ² $xlpage = FmtPageName('$Group.XLPage', $pagename);² if (PageExists($xlpage)) XLPage($xlpage, $xlpage);² =]²With this method you would need to copy any relevant `XLPage into any group which needs the different language support.²²!!!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 PmWikiFr.XLPage)²² [='SearchWiki' => 'Rechercher',=]²²converts "`SearchWiki" to "Rechercher" 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 [[PmWiki:PmWiki | main PmWiki site]] so that they can be made available to others in the ''i18n.tgz'' archive!²²->%note% 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. ²²²!!!Tools for PmWiki localization²²You can help to localize PmWiki in your language in the original site :²²* PmWiki:Localization/Localization²²²%trail% <<|PmWiki.DocumentationIndex|>>
agent=Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; NetCaptor 7.5.2; .NET CLR 1.0.3705)