PmWiki supporte l'internationalisation des pages web, autorisant les caractères accentués dans les noms des pages et la traduction de presque tous les messages internes de PmWiki. La plupart de ces personnalisations linguistiques sont effectuées via la fonction [=XLPage()=] de PmWiki, qui charge un ensemble de variables contenant les traductions à partir d'une page wiki (nommée par convention [=XLPage=], mais qui peut être nommée comme bon vous semble).

(:title Internationalisation:)(:description Interface et contenu du site wiki en langues différentes:)

PmWiki supporte l'internationalisation des pages web, autorisant les caractères accentués dans les noms des pages et la traduction de presque tous les messages internes de PmWiki. La plupart de ces personnalisations linguistiques sont effectuées via la fonction [=XLPage()=] de PmWiki, qui charge un ensemble de variables contenant les traductions à partir d'une page wiki (nommée par convention [=XLPage=], mais qui peut être nommée comme bon vous semble).

Des pages pour plusieurs langues tel que le français, l'allemand, le néerlandais et l'espagnol ont été créées et sont maintenues sur le site pmwiki.org. Vous pouvez télécharger l'archive de ces traductions depuis http://www.pmwiki.com/pub/pmwiki/i18n/i18n-fr.zip. Décompactez la simplement dans le dossier contenant le fichier ''pmwiki.php'' de votre installation. Elle contient un certain nombre de fichiers qui sont placés dans le dossier wikilib.d.

Une fois les pages de traduction installées, activez la nouvelle langue en effectuant un appel à la fonction [=XLPage()=] dans votre fichier ''config.php''. Par exemple, pour activer les messages en français, vous devriez ajouter

qui indique de charger les traductions françaises ('fr') depuis la page PmWikiFr.XLPage. Il est parfaitement possible de charger plusieurs pages en même temps; aussi si vous voulez créer vos propres traductions sans changer celles obtenues de l'archive ''i18n.tgz'', créez juste une autre page (voir ci-dessous) et chargez-là par dessus:

!!!Création de nouvelles traductions

Si la page pour une langue voulue n'existe pas, il est facile d'en créer une ! Un fichier de traduction [=XLPage=] contient simplement des lignes qui ont la forme suivante

où "phrase" est la phrase internationnalisée (écrite @@$[...]@@ dans le code) stockée dans les [[variables]] de type $...Fmt de Pmwiki, et où  "phrase traduite" est l'affichage produit spécifique à votre langue. Par exemple, la ligne (dans [=PmWikiDe.XLPage=])

convertit [="SearchWiki"=] pour afficher "Suchen". Le fichier PmWiki:XLPageTemplate est un bon point de départ pour créer une nouvelle [=XLPage=] et presque toutes les phrases clés de PmWiki y sont déjà centralisées. Notez que le mécanisme de traduction convertit seulement les phrases répertoriées dans les variables $...Fmt -- rien ne sera traduit directement dans les balises wiki.

Si vous créer des nouvelles pages pour d'autres langues, envisagez s'il vous plaît de les inclure sur le [[PmWiki:PmWiki |site officiel de PmWiki]] ainsi elles pourront être mises à disposition à tous dans l'archive ''i18n.tgz'' !

->%green% Notez que le terme "i18n" est communément utilisé comme abréviation du mot anglais "internationalization". Elle dérive du fait qu'il y a 18 lettres entre le "i" et le "n" final et que quelques personnes ne voulaient pas toutes les taper.