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).

Chargement des pages de traduction

Des pages pour plusieurs languages tel que le français, l'allemand, le néerlandais et l'espagnol ont été créées et sont maintenues sur le site pmichaud.com. Vous pouvez télécharger l'archive de ces traductions depuis http://www.pmichaud.com/pub/pmwiki/i18n.tgz(approve sites). Décompactez la simplement dans le dossier contenant le fichier pmwiki.php de votre installation. Elle contient un certain nombres de fichiers qui sont placés dans le dossier wikilid.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

    XLPage('fr','PmWikiFr.XLPage');

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:

    
    XLPage('fr','PmWikiFr.XLPage');       # Les traductions de l'archive i18n.tgz
    XLPage('fr','PmWikiFr.XLPageLocal');  # mes traductions personnelles
    

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

   'phrase' => 'phrase traduite',

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)

   'SearchWiki' => 'Suchen',

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 !

<< | Index doc admin? | >>

Traduction de Internationalizations - page originale sur PmWiki:PmWikiFr.Internationalisation