mkdocs.yml : plugin i18n en mode `suffix` (page.md = fr, page.de.md, page.en.md), fr par défaut, fallback_to_default, un index de recherche par langue, et nav_translations — 29 éléments traduits par langue, vérifié au build. i18n est placé AVANT literate-nav et search : il réécrit l'arbre des fichiers par langue, les autres doivent voir l'arbre déjà localisé. navigation.instant est RETIRÉ de theme.features. Ce n'est pas un arbitrage de confort : il est incompatible avec le lien contextuel du sélecteur de langue de mkdocs-static-i18n, et l'avertissement fait ÉCHOUER `mkdocs build --strict`. Le sélecteur l'emporte — atterrir sur la même page dans l'autre langue vaut plus qu'un chargement instantané qui renvoie à l'accueil. Le commentaire est à l'endroit du retrait, pas ailleurs. Vérifié que literate-nav et static-i18n cohabitent, plutôt que supposé : build construit, nav de /de/ relue dans le HTML produit (« Geräte », « Kompatibilität », liste des appareils bien dépliée). CI : --locales fr,de,en sur la génération ET sur le contrôle d'idempotence. Et une étape qui manquait — gen_api_reference.py n'était pas dans le pipeline, sa sortie ne se propageait donc qu'au prochain passage manuel. requirements.txt : mkdocs-static-i18n >= 1.3. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
5 lines
126 B
Plaintext
5 lines
126 B
Plaintext
mkdocs-material>=9.5
|
|
mkdocs-literate-nav>=0.6
|
|
mkdocs-static-i18n>=1.3 # multi-langue FR/DE/EN (2026-10-12)
|
|
PyYAML>=6.0
|