{"schemaVersion":1,"title":"Versions et langues","url":"https://appgram.github.io/docsy/versions/current/fr/guides/tutorials/versions-and-locales","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/fr/guides/tutorials/versions-and-locales","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/fr/guides/tutorials/versions-and-locales.json","version":"current","locale":"fr","markdown":"# Versions et langues\n\nTestez les sélecteurs, les variantes d’un article et le repli vers la langue par défaut.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nCe portail propose deux versions (**Current** et **Preview (demo)**) et trois langues (**English**, **Français** et **Español**). Les sélecteurs au-dessus de l’article changent de contexte en conservant la page lorsque celle-ci existe.\n\n> Une démonstration, pas une nouvelle version du produit\n>\n> La version Preview contient un guide de démarrage différent pour vérifier les variantes. Les autres articles sont partagés entre les versions. Elle n’annonce aucune fonctionnalité future.\n\n## Tester les quatre combinaisons\n\n1. Ouvrez **Bien démarrer** en version Current et en français.\n2. Choisissez **Preview (demo)** : le titre et le corps du guide changent.\n3. Choisissez **English** : la version Preview reste sélectionnée, mais le guide devient anglais.\n4. Revenez à **Current** : vous retrouvez le guide actuel.\n\n| Contexte | Chemin |\n| --- | --- |\n| Current / English | `/docsy/guides/getting-started` |\n| Current / Français | `/docsy/versions/current/fr/guides/getting-started` |\n| Preview / English | `/docsy/versions/preview/en/guides/getting-started` |\n| Preview / Français | `/docsy/versions/preview/fr/guides/getting-started` |\n\n## Déclarer les versions et les langues\n\n```yaml\nversions:\n  default: current\n  items:\n    - id: current\n      label: Current\n    - id: preview\n      label: Preview (demo)\n      status: beta\nlocalization:\n  defaultLocale: en\n  fallback: true\n  locales:\n    - code: en\n      label: English\n    - code: fr\n      label: Français\n```\n\nLa combinaison par défaut conserve les URL habituelles. Les autres utilisent `/versions/{version}/{locale}` après le chemin de base du site. Une langue peut aussi déclarer `dir: rtl` pour une écriture de droite à gauche.\n\n## Enregistrer les variantes d’un article\n\n```yaml\ncontent:\n  articles:\n    - slug: getting-started\n      source: content/getting-started.md\n      title: Get started with Docsy\n    - slug: getting-started\n      locale: fr\n      source: content/fr/getting-started.md\n      title: Bien démarrer avec Docsy\n    - slug: getting-started\n      version: preview\n      locale: fr\n      source: content/preview/fr/getting-started.md\n      title: Bien démarrer — espace de démonstration\n```\n\nSans `version`, un article est partagé entre les versions. Sans `locale`, il appartient à la langue par défaut. Pour un même article, les variantes propres à une version sont sélectionnées avant les variantes partagées ; Docsy cherche ensuite la langue demandée, puis la langue par défaut si le repli est activé.\n\n## Vérifier le repli en anglais\n\nEn français, ouvrez **Configuration YAML** ou **Recherche et API pour les agents**. Ces articles n’ont pas encore de traduction. Le corps reste en anglais et un message indique le repli. La navigation et la recherche gardent le contexte français.\n\nAvec `fallback: false`, les articles sans traduction disparaissent de cette langue au lieu d’afficher le texte anglais.\n\n## Traduire la navigation et les exports\n\nLes libellés de navigation utilisent `titles.fr`, l’accueil utilise `home.translations.fr`, et les textes de l’interface utilisent `localization.messages.fr`. La traduction est locale et rédigée dans le dépôt ; Docsy n’envoie pas vos articles à un service de traduction.\n\nLes exports Markdown et JSON correspondent à la version et à la langue choisies. Pour un article de repli, `contentLocale` indique `en` et `isFallback` vaut `true`. La recherche inclut uniquement les enregistrements du contexte sélectionné.\n\n","contentLocale":"fr","isFallback":false,"authorship":{"authors":[{"name":"nedimf","kind":"human","github":"nedimf","avatar":"/docsy/assets/authors/nedimf.png","role":"AppGram","id":"nedimf","url":"https://github.com/nedimf"},{"name":"AppGram","kind":"organization","github":"AppGram","url":"https://appgram.dev","avatar":"/docsy/assets/ag-logo.svg","id":"appgram"}],"contributors":[],"reviewedBy":[]},"editUrl":"https://github.com/AppGram/docsy/edit/main/content/fr/versions-and-locales.md"}