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.mdDes 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 letranslationKey, 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.mdet 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.