Introduction des docs
La fonction docs fournit aux utilisateurs un moyen d'organiser les fichiers Markdown dans un format hiérarchique.
ID du document#
Chaque document a un id unique. Par défaut, l'id d'un document est le nom du document (sans l'extension) relatif au répertoire racine de la documentation.
Par exemple, greeting.md a pour id greeting et guide/hello.md a pour id guide/hello.
website # Répertoire racine de votre site└── docs ├── greeting.md └── guide └── hello.mdCependant, la dernière partie de l'id peut être définie par l'utilisateur dans la partie supérieure. Par exemple, si le contenu de guide/hello.md est défini comme ci-dessous, son id final est guide/part1.
---id: part1---Lorem ipsumSi vous voulez plus de contrôle sur la dernière partie de l'URL du document, il est possible d'ajouter un slug (par défaut l'id).
---id: part1slug: part1.html---Lorem ipsumremarque
Il est possible d'utiliser :
- des slugs absolus :
slug: /mySlug,slug: /... - des slugs relatifs :
slug: mySlug,slug: ./../mySlug...
Docs de la page d'accueil#
Si vous voulez qu'un document soit disponible à la racine, et que vous avez un chemin comme https://docusaurus.io/docs/, vous pouvez utiliser le slug du frontmatter :
---id: my-home-docslug: /---Lorem ipsumMode Docs-uniquement#
Si vous ne voulez que la fonction de documentation, vous pouvez faire fonctionner votre site Docusaurus 2 sans page de démarrage et afficher votre page de documentation comme page d'index à la place.
Pour activer le mode Docs-uniquement, définissez le plugin docs routeBasePath: '/', et utilisezslug : / du frontmatter sur le document qui doit être la page d'index (plus d'infos).
caution
Vous devez supprimer la page d'accueil existante ./src/pages/index.js, sinon il y aura deux fichiers qui correspondront à la même route !
astuce
Il y a aussi un « mode blog-uniquement » pour ceux qui ne veulent utiliser que la fonction blog de Docusaurus 2. Vous pouvez utiliser la même méthode décrite ci-dessus. Suivez les instructions de configuration sur le mode Blog-only.