Configuration
Configurez le support multilingue avec le routage par langue, le repli automatique et le sélecteur de langue.
Internationalisation (i18n)
Tiramisu Docs prend en charge plusieurs langues nativement. Chaque langue dispose de son propre dossier, et le framework gère le routage, le repli et le changement de langue.
Configuration
Ajoutez un bloc i18n à votre configuration :
i18n: {
defaultLocale: "en",
locales: [
{ code: "en", label: "English", flag: "🇬🇧" },
{ code: "fr", label: "Français", flag: "🇫🇷" },
{ code: "de", label: "Deutsch", flag: "🇩🇪" },
],
},Structure des dossiers
Chaque langue possède son propre dossier dans src/docs/ :
Chaque dossier (en, fr, de) correspond à un code de langue défini dans votre configuration.
Structure des URL
Les pages sont servies sous leur préfixe de langue :
/docs/getting-started— Version anglaise/docs/fr/getting-started— Version française/docs/de/getting-started— Version allemande
Comportement de repli
Si une page n'existe pas dans la langue sélectionnée, Tiramisu Docs se rabat sur la langue par défaut et affiche une bannière indiquant que la page n'est pas disponible dans la langue choisie.
Sélecteur de langue
Lorsque plusieurs langues sont configurées, un sélecteur de langue apparaît dans la barre latérale. Les utilisateurs peuvent changer de langue et le framework navigue vers la page équivalente dans la langue sélectionnée.