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 site officiel de PmWiki ainsi elles pourront être mises à disposition à tous dans l’archive i18n.tgz !