Comment ajouter une traduction personnalisée au contenu de votre wiki?

28 sept. 2022 5 min read

Écrit par

Andreea Chirica

, Spécialiste Communications et Support

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.

Astuce: Saviez-vous qu'il est facile de devenir un contributeur à XWiki ? Vous pouvez le faire en améliorant les traductions actuelles à l'aide de cette plateforme basée sur Weblate. La communauté XWiki appréciera grandement votre contribution.

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.

  1. Quand un champ de menu est incorrectement affiché
  2. Quand vous voulez traduire un panneau personnalisé sur votre wiki multilingue
    1. Les étapes à suivre
    2. Consultez ce guide vidéo montrant comment traduire le panneau "Démarrage"
  3. 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".

menu-field-translation.png

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.

translationdocumentclass-object.png

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:

core.siblings.title=Pages s\u0153urs de {0}
docextra.siblings=Pages s\u0153urs

Astuce: Vous pouvez trouver les clés de traduction et leurs valeurs enregistrées dans le produit XWiki sur GitHub. Regardez ici la traduction en français (fr). Pour voir d'autres traductions actuelles, vous pouvez simplement remplacer la locale dans l'URL de la page GitHub: par exemple, pour l'allemand, la locale est de et la traduction actuelle dans le produit serait à cet endroit.

4. Finalement, enregistrez la page et voyez le résultat: 

after-addding-translation.png

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:

current-language-left-custom-panel.png

Les étapes à suivre

Vous trouverez ci-dessous les étapes à suivre pour ajouter une traduction à un panneau personnalisé dans XWiki:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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).
  6. 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.
  7. 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.

language-switcher.png

Pour plus de ressources sur la façon d'enrichir votre expérience avec XWiki, vous pouvez consulter notre catégorie Meilleures pratiques.

Articles similaires :