> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/fr/guide-de-lenseignant/teacher-guide/adding-content/multi-language-content.md). # Contenu multilingue Chamilo vous permet de rédiger **plusieurs versions linguistiques d’un même contenu dans un seul champ** — une section de description de cours, un document, une question de test, une enquête — et de faire en sorte que chaque apprenant ne voie automatiquement que la version rédigée dans sa propre langue. Il s’agit de la fonctionnalité **translate\_html**, nommée d’après le paramètre de la plateforme qui la régit. Elle implique trois personnes différentes, chacune en voyant un aspect distinct : * **Votre administrateur** doit activer la fonctionnalité à l’échelle de la plateforme avant que quiconque puisse l’utiliser. * **Vous (l’enseignant)** rédigez les différentes versions linguistiques, à l’aide d’un bouton dans l’éditeur de texte enrichi. * **L’apprenant** en bénéficie sans jamais savoir qu’elle existe — il voit simplement le contenu dans sa propre langue, sans paramètre à trouver ni à activer. ## Activation de la fonctionnalité Il s’agit d’une tâche d’administrateur, et non d’enseignant. Sous **Administration > Paramètres de configuration > Éditeur**, le paramètre **Prise en charge du contenu HTML multilingue** (`translate_html`) doit être activé. Si vous ne voyez pas le bouton **Lang ISO** décrit ci-dessous dans la barre d’outils de votre éditeur, c’est presque certainement la raison — demandez à votre administrateur. Consultez [Paramètres de l’éditeur](/3.x/fr/guide-dadministration/admin-guide/platform-settings/editor-settings.md) pour la référence complète des paramètres. À partir de la v3.0.0, ce paramètre est activé par défaut (ce n’était pas le cas avant cette version), sauf si vous avez mis à niveau votre version depuis une version antérieure où le paramètre était désactivé. Désactiver à nouveau ce paramètre ne supprime ni n’endommage aucun contenu déjà rédigé de cette manière — voir [Ce que voient les apprenants](#what-learners-see) ci-dessous. ## Rédaction de contenu multilingue La fonctionnalité est disponible partout où vous disposez de l’éditeur de texte enrichi complet : sections de [description de cours](/3.x/fr/guide-de-lenseignant/teacher-guide/creating-your-course/course-description.md), [documents](/3.x/fr/guide-de-lenseignant/teacher-guide/adding-content/documents.md), questions de test et d’enquête, et plus encore. 1. Rédigez (ou collez) le contenu dans votre langue par défaut, comme d’habitude. 2. Sélectionnez ce texte, puis cliquez sur le bouton **Lang ISO** dans la barre d’outils de l’éditeur. 3. Dans le menu, choisissez la langue dans laquelle vous venez d’écrire — la liste couvre toutes les langues actives de votre plateforme. Si celle dont vous avez besoin n’y figure pas, utilisez **Custom Chamilo ISO code...** en bas et saisissez-la (par ex. `en_US`, `fr_FR`, `es`). 4. Chamilo entoure votre sélection de cette balise de langue. Rédigez (ou collez) ensuite la version de la langue suivante juste après, sélectionnez-la, et répétez avec une langue différente. Continuez pour autant de langues que vous souhaitez couvrir. Toutes se trouvent dans le même champ — pendant que vous éditez, vous verrez toutes les versions linguistiques empilées les unes après les autres ; ce n’est que lorsqu’une personne *consulte* réellement la page que Chamilo masque tout sauf la langue qui s’applique à elle (voir ci-dessous). ### Traduction assistée par IA Si votre administrateur a configuré un fournisseur de texte IA, le même menu **Lang ISO** propose également **Add translation to...** en haut. Cela envoie votre contenu existant au modèle d’IA configuré et insère un nouveau bloc traduit automatiquement dans la langue que vous choisissez (ou dans toutes les langues restantes à la fois, si votre plateforme le permet) — vous n’avez pas à le rédiger vous-même. Les blocs linguistiques existants restent inchangés, et les langues déjà présentes sont exclues de la liste, de sorte qu’une utilisation répétée ne créera pas de doublons. Comme pour tout contenu généré par IA, relisez le résultat — c’est un moyen rapide d’obtenir une première ébauche solide dans une langue que vous ne parlez peut-être pas vous-même, et non un substitut à la relecture. ## Ce que voient les apprenants Chaque apprenant voit exactement une version linguistique : Chamilo essaie d’abord sa propre langue d’interface ; si aucun de vos blocs ne correspond, il se rabat sur la langue du cours, puis sur la langue par défaut de la plateforme ; si aucune de celles-ci ne correspond non plus, il affiche la langue que vous avez écrite en premier plutôt que de laisser le contenu vide. Tout cela se produit automatiquement — il n’y a rien à configurer pour l’apprenant, et rien à configurer par apprenant de votre côté non plus. Voici la même section de description de cours, telle que vue par trois apprenants avec des langues d’interface différentes — rien d’autre dans le cours n’a changé entre ces trois captures d’écran, seule la langue du visiteur : ### Sous le capot Si vous ouvrez un jour la vue **Code source** d’un champ multilingue (le bouton `<>` de la barre d’outils de l’éditeur), vous verrez chaque version linguistique encapsulée de la façon suivante : Chaque version est encapsulée dans un `
` (ou un ``, pour une courte expression en ligne plutôt qu’un bloc entier) — c’est cet attribut `lang` que Chamilo compare à la langue du visiteur pour décider ce qu’il faut afficher. Il est utile de reconnaître ce nom de classe précis si vous inspectez le code source d’une page ou si vous diagnostiquez un contenu qui s’affiche mal : **`mce-translatehtml`** est le marqueur à rechercher. Cela explique également pourquoi la désactivation de `translate_html` dans les paramètres de la plateforme ne casse rien de ce qui a déjà été rédigé : le paramètre ne contrôle que l’affichage du bouton d’*édition* **Lang ISO** dans l’éditeur. Le filtrage côté *affichage* décrit plus haut s’exécute de façon inconditionnelle, de sorte que le contenu multilingue déjà rédigé reste correctement filtré pour chaque visiteur, même sur une plateforme où un administrateur a depuis désactivé le bouton d’édition. ## Les titres ne fonctionnent pas ainsi Le titre d’un cours, le titre d’un document, le titre d’un test — ce sont des champs de texte brut, pas du texte enrichi, ils ne peuvent donc pas contenir le balisage étiqueté `lang` décrit plus haut. Ils restent une valeur unique et neutre, quel que soit le visiteur, peu importe le nombre de versions linguistiques que vous avez rédigées dans le contenu sous-jacent. La seule exception : si votre administrateur a activé **Enregistrer les titres en HTML** (`save_titles_as_html`, également sous **Administration > Paramètres de configuration > Éditeur**) pour le champ de titre concerné, ce champ devient alors un véritable champ HTML, et la même technique **Lang ISO** décrite plus haut peut lui être appliquée. C’est peu courant et surtout utilisé pour les questions de test — la plupart des titres de la plateforme restent du texte brut. ## Conseils * **Conservez la langue source en premier** — placez la langue la plus courante de votre plateforme en premier dans le champ ; c’est le repli le plus naturel si vous oubliez d’étiqueter une langue plus rare par la suite. * **N’imbriquez pas les blocs de langue** — rédigez chaque version comme un bloc distinct et séquentiel ; encapsuler l’un dans l’autre n’est pas pris en charge et l’éditeur désimbrique activement les marqueurs imbriqués lorsque vous en insérez un nouveau. * **Une section qui paraît vide dans une langue** signifie généralement qu’aucun bloc n’a jamais été étiqueté pour celle-ci (ni pour son repli étendu cours/plateforme par défaut) — vérifiez la vue Code source pour les langues réellement présentes.