Lorsqu'il s'agit d'utiliser XWiki dans un contexte multinational, il est bon de savoir que XWiki peut être configuré pour fonctionner dans une ou plusieurs langues. Actuellement, le produit XWiki est traduit en 40 langues. Si vous voulez d'abord apprendre à changer la langue par défaut de votre wiki ou à rendre votre wiki multilingue, consultez cet article.
Il existe de multiples situations dans lesquelles vous pourriez avoir besoin d'ajouter une traduction personnalisée sur votre wiki. Vous trouverez ci-dessous plus de détails sur chaque cas et les solutions proposées.
- Quand un champ de menu est incorrectement affiché
- Quand vous voulez traduire un panneau personnalisé sur votre wiki multilingue
- Option bonus: Sélecteur de langue en bas de page de votre site basé sur XWiki
Quand un champ de menu est incorrectement affiché
Dans le cas d'un wiki dont la langue est actuellement le français (fr), nous pouvons remarquer dans la capture d'écran ci-dessous que le champ de menu Pages "sœurs" est rendu par Pages "sœurs".
Ceci peut être facilement corrigé sur votre wiki avec une simple solution:
1. Créez une nouvelle page sur votre wiki, le nom et l'emplacement ne sont pas importants, mais il devrait au moins être suggestif qu'il s'agit d'une traduction (par exemple: XWiki.TranslateSiblings - une nouvelle page appelée TranslateSiblings dans l'espace XWiki).
2. Editez cette nouvelle page en mode objet, et ajoutez l'objet TranslationDocumentClass (pour le champ Scope, vous devriez sélectionner WIKI, ou GLOBAL si vous voulez qu'il soit visible depuis d'autres wikis également). Sauvegardez le nouvel objet de la page.
3. Maintenant, éditez la même page en mode Wiki, et comme contenu, vous devez ajouter les traductions souhaitées en français, dans un format clé=valeur. Dans ce cas:
docextra.siblings=Pages s\u0153urs
4. Finalement, enregistrez la page et voyez le résultat:
Quand vous voulez traduire un panneau personnalisé sur votre wiki multilingue
Dans le cas où vous auriez un wiki multilingue avec l'anglais (en), le français (fr), l'allemand (de) et l'espagnol (es) comme langues supportées, et que vous avez un panneau personnalisé qui est actuellement affiché dans une seule langue, vous pouvez utiliser les étapes suivantes pour traduire le panneau dans les langues restantes. Disons que votre wiki est actuellement réglé en anglais. Votre panneau personnalisé s'appelle Getting Started et s'affiche dans le panneau gauche du wiki:
Les étapes à suivre
Vous trouverez ci-dessous les étapes à suivre pour ajouter une traduction à un panneau personnalisé dans XWiki:
- Créez une nouvelle page qui deviendra la page des traductions. Pour cet exemple, j'ai choisi de créer une page appelée GS-Custom-Translation dans l'espace Panels.
- Modifiez la page en mode objet et ajoutez l'objet TranslationDocumentClass (pour "Scope", vous devez sélectionner WIKI, ou GLOBAL si vous comptez utiliser le panneau sur d'autres subwikis multilingues). Sauvegardez la page.
- Ensuite, éditez la même page en mode wiki. Puis, voyez pour quelle langue vous êtes en train d'ajouter une traduction sur le panneau de droite Page Translations, où vous verriez un message comme "You are editing the original page (en)" si la page a été créée alors que le wiki était réglé sur l'anglais.
- Lorsque vous éditez la page en mode wiki, c'est ici que vous ajoutez les clés de traduction représentant le contenu du panneau que vous souhaitez traduire. Vous pouvez composer des noms de clés suggestifs, mais le format devra être key=value (dans mon exemple, pour le titre du panneau, j'ai ajouté panels.gettingstarted.title=Getting Started). Continuez avec une clé pour chaque section de contenu que vous souhaitez traduire.
- Après avoir ajouté et enregistré les traductions anglaises, vérifiez le panneau Page Translations sur la droite et cliquez sur la locale de la langue à partir de la section Translate this document in: fr (la partie des clés doit rester identique entre les langues).
- Lorsque vous avez terminé et enregistré la nouvelle traduction, cliquez sur les autres versions de traduction, de et es, et modifiez les valeurs de traduction en conséquence.
- Maintenant que vous avez ajouté les traductions, allez sur le panneau Getting Started, éditez la page et remplacez le texte pour lequel vous avez créé une traduction par le texte suivant : $services.localization.render('insert here the key from the translation document'). Par exemple: pour le titre du panneau, vous devrez modifier la ligne #panelheader('Getting Started') comme suit #panelheader($services.localization.render('panels.gettingstarted.title'))
Si vous choisissez d'ajouter ou de modifier du contenu dans le panneau Getting Started, vous pouvez revenir aux pages GS-Custom-Translation résultantes et mettre à jour les clés de traduction si nécessaire.
Consultez ce guide vidéo montrant comment traduire le panneau "Démarrage"
Option bonus: Sélecteur de langue en bas de page de votre site basé sur XWiki
Consultez le pied de page de cette page pour voir le bouton Langue qui comprend actuellement un commutateur entre la version anglaise et la version française de cette page. Il s'agit d'une fonctionnalité développée sur mesure pour xwiki.com et nous serions heureux de vous offrir du support pour rendre votre wiki multilingue adaptée aux besoins de votre entreprise.