Traduction dans Drupal : symétrique ou asymétrique, comment choisir

· 10 min de lecture

Sur un site multilingue, la question qu’on pose en premier est « quelles langues ? ». La question qu’on devrait poser juste après, et qu’on oublie presque toujours, est : est-ce que la version anglaise d’une page a la même structure que la version française ?

La réponse détermine la configuration des champs, le choix des modules de mise en page, le workflow des traducteurs et la quantité de travail à chaque modification. Et elle est très coûteuse à changer une fois le site rempli.

Il y a deux modèles :

  • traduction symétrique : toutes les langues partagent la même structure, seuls les textes changent ;
  • traduction asymétrique : chaque langue peut avoir sa propre structure, ses propres blocs, ses propres images.

Cet article explique comment Drupal implémente ces deux modèles, comment ils se déclinent avec Paragraphs, Layout Builder et Drupal Canvas, et comment choisir.

Les deux modèles

Symétrique Asymétrique
Structure de la page Identique dans toutes les langues Propre à chaque langue
Ajouter une section Dans la langue d’origine, elle apparaît partout Dans une langue, sans toucher les autres
Travail du traducteur Traduire des textes Traduire et composer la page
Cohérence entre langues Garantie À la charge des équipes
Outils de traduction (TMGMT, agences) Très adaptés Plus difficiles à industrialiser
Cas typique Site institutionnel traduit à l’identique Sites pays avec des équipes locales

Aucun des deux n’est meilleur dans l’absolu. Le symétrique garantit la cohérence et simplifie la traduction. L’asymétrique donne de la liberté aux équipes locales, au prix d’une maintenance plus lourde.

Le principe qui explique tout : un champ traduisible ou partagé

Dans Drupal, une traduction n’est pas une entité séparée. Un nœud a une entité, avec plusieurs traductions. Et chaque champ est, soit :

  • traduisible : chaque langue a sa propre valeur ;
  • non traduisible (partagé) : la valeur est la même pour toutes les langues, et la modifier dans une langue la modifie partout.

Ce réglage se fait par champ, dans Configuration > Région et langue > Langue du contenu et traduction (/admin/config/regional/content-language).

Tout le reste découle de cette règle. Symétrique ou asymétrique n’est pas un réglage global : ça se décide champ par champ.

  • Un champ texte traduisible : chaque langue a son texte. C’est le cas normal.
  • Un champ de référence (vers des médias, des paragraphes, des termes) non traduisible : toutes les langues pointent vers les mêmes entités. La structure est partagée : c’est symétrique.
  • Le même champ de référence traduisible : chaque langue pointe vers ses propres entités. La structure peut diverger : c’est asymétrique.

Traduire une partie d’un champ seulement

Certains types de champs vont plus loin, en découpant leurs colonnes en groupes. Le champ image en est l’exemple le plus utile : il déclare trois groupes, file (le fichier, sa largeur, sa hauteur), alt et title.

Quand le champ image est traduisible, l’écran de traduction propose de choisir quels groupes sont traduits. Configuration la plus courante : le fichier est partagé, l’alt et le title sont traduits. Elle est stockée dans le champ :

# field.field.media.image.field_media_image.yml
third_party_settings:
  content_translation:
    translation_sync:
      file: '0'     # partagé entre les langues
      alt: alt      # traduit
      title: title  # traduit

C’est de la traduction symétrique pour l’image, et asymétrique pour son texte alternatif. On ne peut pas faire plus fin.

Vérifier rapidement la configuration d’un type de contenu

Sur un site existant, savoir ce qui est partagé et ce qui est traduit demande d’ouvrir beaucoup d’écrans. Ce petit script donne la réponse d’un coup :

drush php:eval '
$fields = \Drupal::service("entity_field.manager")->getFieldDefinitions("node", "page");
foreach ($fields as $name => $definition) {
  if (str_starts_with($name, "field_")) {
    printf("%-30s %s\n", $name, $definition->isTranslatable() ? "traduit" : "PARTAGÉ");
  }
}'

Où modifier un champ partagé ?

C’est la conséquence du modèle symétrique que les équipes découvrent en production.

Si un champ est partagé, le modifier depuis la traduction anglaise modifie aussi la version française. Pour éviter qu’un traducteur change la structure sans le savoir, le module Content Translation propose, par type de contenu, l’option « Masquer les champs non traduisibles sur les formulaires de traduction » (Hide non translatable fields on translation forms). Les champs partagés ne se modifient alors que dans la langue d’origine.

Avec Content Moderation, la règle devient plus stricte. Le cœur applique une contrainte de validation (EntityUntranslatableFieldsConstraint) dont les messages sont explicites :

  • Non-translatable fields can only be changed when updating the current revision.
  • Non-translatable fields can only be changed when updating the original language.

Autrement dit : on ne peut pas modifier un champ partagé dans une révision brouillon, sauf si l’option ci-dessus est activée. Et dans ce cas, seulement depuis la langue d’origine. Si vos éditeurs voient l’un de ces messages, ce n’est pas un bug : c’est le modèle symétrique qui protège les autres langues.

Les références : médias et termes

Le cas des médias montre bien comment combiner les deux modèles.

Le même visuel dans toutes les langues (symétrique) : le champ média du nœud est partagé, et c’est l’entité média elle-même qui est traduisible, avec son alt traduit comme vu plus haut. À l’affichage, Drupal charge la traduction du média dans la langue courante (EntityRepository::getTranslationFromContext()).

Un visuel différent par langue (asymétrique) : le champ média du nœud devient traduisible. Chaque traduction pointe vers son propre média. C’est utile pour une image qui contient du texte, une affiche de campagne locale, une photo de l’équipe d’un pays.

On peut parfaitement avoir les deux sur le même type de contenu : un visuel principal partagé et un bandeau promotionnel traduisible.

Paragraphs

Paragraphs est conçu pour la traduction symétrique, et le module le dit clairement.

La configuration supportée :

  • le champ de paragraphes du nœud (entity_reference_revisions) est non traduisible ;
  • les types de paragraphes sont traduisibles, avec leurs champs texte traduisibles.

Si vous cochez « traduisible » sur un champ de paragraphes, le module affiche un avertissement : Paragraphs fields do not support translation.

Dans ce mode, le widget Paragraphs bloque toute modification de structure quand on édite une traduction : pas d’ajout, pas de suppression, pas de réordonnancement. Le traducteur ne voit que les textes à traduire. C’est exactement le comportement attendu d’une traduction symétrique.

Paragraphs en asymétrique

Pour permettre une structure différente par langue, il existe le module contrib Paragraphs Asymmetric Translation Widgets (8.x-1.4, compatible Drupal 11). Il fournit des widgets qui acceptent un champ de paragraphes traduisible : chaque traduction a alors ses propres paragraphes, qu’on peut ajouter, supprimer et réordonner indépendamment des autres langues.

Le point à retenir est sur sa page de projet : passer des widgets standard au widget asymétrique sur un site existant peut causer une perte de données. Les paragraphes dont le champ parent passe de non traduisible à traduisible peuvent se retrouver détachés de leur contenu : toujours en base, mais plus affichés. C’est une décision à prendre au début du projet, pas en cours de route.

J’ai comparé Paragraphs à d’autres approches dans Paragraphs ou Inline Entity Form.

Layout Builder

En core, Layout Builder ne permet pas de traduire une mise en page surchargée :

  • le champ qui stocke la mise en page d’un contenu (layout_builder__layout) est créé non traduisible ;
  • l’accès à l’onglet Mise en page est refusé sur les traductions : on ne peut modifier la mise en page que dans la langue d’origine.

Résultat : en core seul, la mise en page est partagée, et les textes des blocs placés dans la mise en page (libellés, blocs inline) ne se traduisent pas. Deux modules contrib couvrent les deux modèles :

  • Layout Builder Symmetric Translations (2.0.0, Drupal 10.2+ et 11) : la mise en page reste identique, et on peut traduire les libellés des blocs et le contenu des blocs inline. Le module est en maintenance minimale.
  • Layout Builder Asymmetric Translation (3.0.2, Drupal 10.2+ et 11) : le champ de mise en page devient traduisible, chaque langue a sa propre mise en page. Un réglage du widget détermine si les blocs sont copiés à la création d’une traduction.

Les deux modules ne peuvent pas être utilisés sur le même site. Encore une fois, c’est un choix d’architecture.

Drupal Canvas

Drupal Canvas a fait le choix du symétrique. D’après sa documentation officielle, toutes les traductions partagent le même arbre de composants, et seules les entrées traduisibles de chaque composant diffèrent par langue.

Ce qu’il faut savoir aujourd’hui :

  • il faut rendre l’entité Page traduisible, avec le champ Components, et activer Configuration Translation pour les régions globales et les modèles de contenu ;
  • l’interface de Content Translation du cœur ne sait pas traduire le contenu Canvas : il faut passer par TMGMT ou par le module expérimental Canvas Translate, qui ajoute un panneau de traduction dans l’éditeur ;
  • la traduction asymétrique est en cours de travail dans le projet Canvas (issue #3571130), et le module contrib Canvas Multilingual (en bêta) corrige plusieurs problèmes des sites multilingues.

Le support multilingue de Canvas évolue vite. Pour un projet qui démarre, vérifiez l’état de ces modules au moment de choisir.

Comment choisir

Quelques questions suffisent, à poser avant de créer le premier champ.

Qui produit le contenu des autres langues ? Une agence de traduction ou un outil de traduction (TMGMT, traduction automatique relue) : symétrique. Des équipes locales qui rédigent pour leur marché : l’asymétrique devient pertinent.

Les pages doivent-elles dire la même chose ? Contraintes légales, documentation produit, site institutionnel : symétrique. Offres différentes par pays, campagnes locales : asymétrique, au moins sur certains champs.

Qui maintient la cohérence ? En symétrique, Drupal la garantit. En asymétrique, ce sont les équipes. Ajouter une section à la page française ne l’ajoute nulle part ailleurs, et dans deux ans les versions auront divergé.

Les différences sont-elles ponctuelles ou structurelles ? C’est souvent la question décisive. Si seuls un visuel, un lien ou un bandeau changent selon la langue, il suffit de rendre ces champs-là traduisibles et de garder le reste symétrique. Si la page entière est différente, ce n’est peut-être plus une traduction.

La solution hybride, souvent la bonne

Dans la plupart des projets que j’ai vus, la bonne configuration est :

  • une structure symétrique par défaut (paragraphes ou mise en page partagés) ;
  • quelques champs traduisibles choisis : visuel principal, lien d’appel à l’action, bandeau promotionnel ;
  • pour les pages vraiment propres à un pays, un contenu distinct, publié dans une seule langue, plutôt qu’une traduction forcée.

Ce dernier point est souvent oublié : un contenu n’a pas besoin d’exister dans toutes les langues. Une page « Événement à Lyon » en français uniquement n’est pas une traduction manquante, c’est un contenu local.

Les pièges à éviter

Changer le modèle en cours de projet. Rendre traduisible un champ de référence qui contient déjà des données, ou l’inverse, a des effets sur les traductions existantes. Avec Paragraphs, le risque de perte de données est documenté. Testez toujours sur une copie de la base de production.

Mélanger les deux sans le décider. Un champ laissé traduisible par défaut alors que le reste est symétrique crée des pages où un seul élément diverge, sans que personne ne sache pourquoi.

Oublier les éditeurs. En symétrique, ils doivent savoir que la structure se modifie dans la langue d’origine. En asymétrique, ils doivent savoir que leurs modifications ne se propagent pas. Les deux se documentent.

Oublier le référencement. En asymétrique, deux versions très différentes restent liées par hreflang comme traductions l’une de l’autre. Si elles ne parlent plus du tout de la même chose, ce lien n’a plus de sens : c’est un autre signe qu’il faut des contenus distincts.

Checklist avant de configurer un site multilingue

  • Qui produit les contenus des autres langues est clair : traducteurs ou équipes locales.
  • Le modèle par défaut est choisi : symétrique ou asymétrique.
  • Pour chaque champ de référence (paragraphes, médias, mise en page), on a décidé s’il est partagé ou traduit.
  • Les champs image ont leurs groupes configurés : fichier partagé ou traduit, alt traduit.
  • L’option « Masquer les champs non traduisibles » est activée si le site utilise Content Moderation.
  • Les modules de mise en page ont été choisis en fonction du modèle (layout_builder_st ou layout_builder_at, widget Paragraphs standard ou asymétrique).
  • Les pages propres à une langue sont des contenus distincts, pas des traductions.
  • Les règles sont documentées pour les éditeurs.

La traduction dans Drupal est puissante parce qu’elle se règle champ par champ. C’est aussi ce qui la rend piégeuse : sans décision explicite au départ, chaque champ prend sa valeur par défaut, et le modèle du site se décide tout seul.