{"schemaVersion":1,"title":"Des articles plus expressifs","url":"https://appgram.github.io/docsy/versions/current/fr/guides/tutorials/rich-articles","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/fr/guides/tutorials/rich-articles","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/fr/guides/tutorials/rich-articles.json","version":"current","locale":"fr","markdown":"# Des articles plus expressifs\n\nAjoutez des encadrés, des étapes, des onglets, des blocs de code et des extraits réutilisables en Markdown.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nLes composants Docsy s’écrivent directement en Markdown. Les réglages restent dans YAML ; le contenu reste lisible dans votre dépôt et dans les exports pour les agents. Aucun service de rédaction ni police distante n’est nécessaire.\n\n## Encadrés\n\n> La configuration appartient à YAML\n>\n> Gardez l’identité du produit, la navigation, les sources et les permissions dans `docsy.config.yaml`. Rédigez les explications ici, en Markdown.\n\n> Validez avant de publier\n>\n> Exécutez `npm run validate` pour détecter les liens cassés, les composants invalides et les erreurs d’importation avant la publication.\n\n> Gardez vos secrets hors du dépôt\n>\n> Lisez les identifiants privés depuis l’environnement du serveur. Ne les ajoutez jamais au YAML ni aux exemples publiés.\n\n> Un site statique ne protège pas les articles\n>\n> Utilisez le serveur Node pour les pages verrouillées. Un contrôle effectué uniquement dans le navigateur ne peut pas protéger un fichier public.\n\nChaque type possède une icône et un accent discret. Le titre explique la situation ; le corps indique quoi faire. La distinction ne repose pas uniquement sur la couleur.\n\n```md\n:::warning[Gardez vos secrets hors du dépôt]\nLisez les identifiants privés depuis l’environnement du serveur.\n:::\n```\n\n## Étapes numérotées\n\n> 1. **Générez un projet.** Partez de l’interface modifiable de Docsy.\n>\n> 2. **Configurez les sources.** Déclarez les articles, la spécification API et les métadonnées SDK dans YAML.\n>\n> 3. **Validez et publiez.** Vérifiez le résultat avant de le déployer.\n\nPlacez une liste Markdown ordonnée entre `:::steps` et `:::`. Les paragraphes et les blocs de code peuvent faire partie d’une étape.\n\n## Onglets synchronisés\n\nLes groupes utilisant la même clé `sync` mémorisent le même libellé dans le stockage local du navigateur.\n\n> > npm\n> >\n> > ```bash\n> > npm run validate\n> > npm run build\n> > ```\n>\n> > pnpm\n> >\n> > ```bash\n> > pnpm validate\n> > pnpm build\n> > ```\n\nUtilisez quatre deux-points pour le groupe `tabs` et trois pour chaque enfant `tab`. Le clavier permet de naviguer avec les flèches, Début et Fin. Sans JavaScript, tous les panneaux restent visibles.\n\n## Groupes de code\n\nEntourez les blocs de code avec `:::code-group`. Le texte placé après la langue du bloc devient le libellé de l’onglet.\n\n> ```javascript JavaScript\n> console.log('Une documentation qui vous appartient.');\n> ```\n>\n> ```python Python\n> print('Une documentation qui vous appartient.')\n> ```\n\n## Explications repliables\n\n> Que se passe-t-il sans JavaScript ?\n>\n> Les onglets restent lisibles et les sections repliables utilisent l’élément natif `details` du navigateur. La recherche indexe tous les panneaux, pas uniquement celui qui est sélectionné.\n\n## Extraits réutilisables\n\nDéclarez les fichiers Markdown dans YAML :\n\n```yaml\ncontent:\n  snippets:\n    publicationFr: content/snippets/publishing-checklist.fr.md\n```\n\nInsérez ensuite `::include{src=\"publicationFr\"}` sur sa propre ligne :\n\n* Validez les sources configurées, les liens internes et les ancres.\n* Construisez les versions et les langues que vous souhaitez publier.\n* Vérifiez les exemples et les permissions avant le déploiement.\n\nLes extraits sont développés dans les articles, la recherche, les exports Markdown et les documents JSON. Les noms inconnus, les cycles, les chemins hors du projet et plus de dix inclusions imbriquées font échouer la validation.\n\n## Choisir les composants autorisés\n\n```yaml\ncontent:\n  components: [note, tip, warning, danger, steps, tabs, accordion, code-group, include]\n```\n\nUn composant inconnu, désactivé ou mal structuré empêche la publication. Le composant `tab` doit toujours être un enfant de `tabs`.\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/rich-articles.md"}