Pages bilingues

Le contenu est bilingue: une page est une paire de fichiers avec suffixe de langue, côte à côte dans le même répertoire, chacun publié sous sa propre URL selon la langue.

content/docs/site-governance/content/example.en.md
content/docs/site-governance/content/example.fr.md

Des noms de fichiers identiques lient les deux fichiers comme traductions automatiquement. Quand les noms diffèrent, le même translationKey dans les deux fichiers les lie à la place.

Quatre règles gardent la paire cohérente:

  • Toutes les pages n’ont pas de traduction. Une page peut exister dans une seule langue; vérifiez que le fichier jumeau existe avant de créer un lien d’une langue à l’autre.
  • Le fichier français peut définir slug: pour donner à la traduction une URL localisée. Le lien de traduction survit parce qu’il repose sur le nom de fichier ou le translationKey, pas sur l’URL.
  • Les chemins related: sont indépendants de la langue. Chaque site linguistique les résout sur ses propres pages: la liste identique va donc dans le front matter du .en.md et du .fr.md — une liste tenue dans un seul fichier laisse l’autre langue n’afficher rien. Voir Renvois.
  • Le code reste tel quel. Les commandes, chemins, clés de configuration et exemples de shortcodes sont identiques dans les deux fichiers; seule la prose est traduite.