Contenus multilingues

Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Contenus multilingues et celle pour Moodle 3.x est consultable là : Contenus multilingues.

Le filtre Contenus multilingues permet de créer des ressources en plusieurs langues. Quand il est activé, il cherche des balises <span lang="xx" class="multilang"> qui indiquent qu'un texte contient plusieurs langues. Ensuite, il sélectionne et utilise la langue à présenter pour l'utilisateur. La langue d'une ressource changera si l'utilisateur change la langue dans son profil.

Moodle1.8

La syntaxe du filtre multilingue a été modifiée dès Moodle 1.8. La syntaxe <lang> n'est plus supportée. Il est en outre nécessaire d'ajouter class="multilang" dans chaque balise <span> d'un bloc multilingue. La nouvelle syntaxe est compatible avec les anciens filtres, ce qui signifie qu'elle peut être utilisée avec d'anciennes versions de Moodle.

Comment utiliser le filtre multilingue ?

Pour utiliser cette fonctionnalité, vous devez d'abord créer votre contenu dans plusieurs langues (dans la même ressource). Ensuite, encadrez le bloc de chaque langue (bloc multilingue) par les balises suivantes :

  <span lang="XX" class="multilang">votre contenu ici</span>
  <span lang="YY" class="multilang">votre contenu dans une autre langue ici</span>

Pour saisir ces balises, il est impératif d'être en Mode code HTML (cliquez sur [<>] dans l'éditeur WYSIWYG). Seuls les espaces, tabulations et retours à la ligne peuvent être utilisés entre les différentes langues d'un bloc multilingue. Notez que class="multilang" n'est pas nécessaire avant Moodle 1.8.

Le code suivant NE fonctionne PAS

  <lang="XX">votre contenu ici</lang>
  <lang="YY">votre contenu dans une autre langue ici</lang>

L'ancienne syntaxe

  <lang lang="XX">votre contenu ici</lang>
  <lang lang="YY">votre contenu dans une autre langue ici</lang>

  <span lang="XX">votre contenu ici</span>
  <span lang="YY">votre contenu dans une autre langue ici</span>

ne fonctionnera pas avec les versions 1.8 et ultérieures de Moodle. Dès la version 1.8, l'attribut lang sans class="multilang" peut être utilisé pour marquer la langue du texte - voir http://www.w3.org/TR/html4/struct/dirlang.html.

Comment cela fonctionne en interne ?

  1. Le filtre cherche d'abord les blocs multilingues dans le texte.
  2. Pour chaque bloc multilingue :
    • s'il y a des textes dans la langue active, le filtre les affiche ;
    • sinon, s'il y a des textes dans la langue parente de la langue active, le filtre les affiche ;
    • sinon, le filtre affiche la première langue trouvée dans le texte.
  3. Les textes en dehors des blocs multilingues sont toujours affichés

Résumé de cours et balise de titre

Pour que le filtre fonctionne également dans les titres, la barre de navigation et les résumés des ressources, il faut activer l'option Filtrer toutes les chaînes de caractères dans l'administration du site, sous Présentation > Réglages filtres.

<span lang="en" class="multilang">Mathematics</span> <span lang="fr" class="multilang">Mathématiques</span>

formera un titre en anglais et en français.

Cela fonctionne de la même façon dans le résumé du cours :

<span lang="en" class="multilang">Growth is often a major concern in planning society.
How can one avoid superficial conclusions?</span>
<span lang="fr" class="multilang">La croissance est souvent une difficulté majeure de la planification
Comment peut-on éviter les conclusions superficielles ?</span>

Traductions avec balises

Si l'on souhaite traduire un mot ou une phrase dans une langue choisie dans un texte en français :

<span lang="fr" class="multilang>Si je veux intégrer une explication dans un texte, puis-je le faire ?</span>
Si je veux intégrer une explication <span lang="fr"> </span>
     <span lang="en" class="multilang">(en:explanation)</span> dans un texte, puis-je le faire ?
<span lang="en" class="multilang>Si je veux intégrer une explication (en:explanation)
     dans un texte, puis-je le faire ?</span>

les 3 formulations ci-dessus fonctionneront toutes, mais pas les 2 suivantes :

Si je veux intégrer une explication <span lang="fr" class="multilang></span>
     <span lang="en" class="multilang>(en:explanation)</span> dans un texte, puis-je le faire ?
Si je veux intégrer une explication <span lang="en" class="multilang>(en:explanation)</span>
     dans un texte, puis-je le faire ?

Qui afficheront le texte anglais, même si le français était la langue choisie. NOTEZ qu'avant 1.8, "span lang=fr" doit contenir quelque chose, au moins un espace.

Nouvelle syntaxe multilingue

Moodle1.8


  • Les balises <span lang="xx"> et <lang> ne doivent plus être utilisées.
  • Les contenus existants peuvent être mis à jour en utilisant le script admin/multilangupgrade.php. Un lien vers ce script est présenté sur la page de notification administrateur si la mise à jour est requise.
  • Le filtre multilingue peut être configuré pour utiliser uniquement l'ancienne syntaxe. Voir l'option Imposer l'ancienne syntaxe du filtre multilingue dans les paramètres du filtre. Ce paramètre est susceptible d'être supprimé en 1.9.
  • La nouvelle syntaxe est imposée dans les nouvelles installations de Moodle 1.8. Pour les sites mis à jour, la nouvelle syntaxe est activée après la mise à jour des contenus multilingues.

Résolution de problèmes habituels

  • Les contenus de toutes les langues sont affichés : le filtre Contenus multilingues n'est pas activé. Activez-le dans l'administration du site, sous Modules > Filtres.
  • Les titres et la barre de navigation ne fonctionnent pas comme prévu : l'option Filtrer toutes les chaînes de caractères n'est pas activée. Activez-la dans l'administration du site, sous Présentation > Réglages filtres.
  • Des caractères parasites s'affichent entre les textes des différentes langues : l'éditeur WYSIWYG ajoute parfois des <br /> ou d'autres balises. Contrôlez votre texte en mode HTML.
  • Des espaces supplémentaires dans la balise span lang
  • Il n'est pas simple d'accéder au menu déroulant de changement de langue ! C'est possible uniquement depuis la page d'accueil, ou an modifiant le profil. Si vous voulez changer cela, voir [http://tracker.moodle.org/browse/MDL-11531 MDL-11531]

Voir aussi

Les discussions suivantes sur Using Moodle (en anglais) :