Organiser la navigation

Réordonnez les pages, ajoutez des groupes et gérez la structure de la barre latérale de votre documentation par glisser-déposer dans l’éditeur web de Mintlify, sans modifier docs.json.

Utilisez la barre latérale de navigation pour organiser votre documentation. Les modifications que vous apportez dans l’éditeur sont synchronisées avec votre référentiel lorsque vous publiez — vous n’avez pas besoin de modifier docs.json manuellement.

​

Ajouter des éléments de navigation

Cliquez sur Add new au bas de l’arborescence de navigation pour ajouter un nouvel élément au niveau racine. Pour ajouter un élément imbriqué dans un autre, cliquez sur le bouton plus à côté de cet élément.

Après avoir créé un élément, faites-le glisser-déposer pour le réordonner ou l’imbriquer. Survolez un élément et cliquez sur l’icône d’engrenage pour configurer ses propriétés.

Cliquez avec le bouton droit sur une page pour ouvrir ses paramètres ou la supprimer.

Cliquez avec le bouton droit sur un élément de navigation pour ouvrir ses paramètres, le convertir en un autre type d’élément, le dupliquer, ajouter une page à l’intérieur, ajouter un groupe à l’intérieur, le dégrouper ou le supprimer.

Certains éléments ne peuvent pas être imbriqués dans d’autres. Par exemple, les onglets ne peuvent pas être imbriqués dans des groupes. L’éditeur vous empêche de créer des combinaisons non valides.

​

Éléments de navigation

Choisissez la bonne structure pour votre contenu :

• Pages — Fichiers de documentation individuels. Le bloc de construction fondamental de la navigation.
• Groups — Sections repliables regroupant des pages connexes. Peuvent être imbriquées dans d’autres groupes.
• Tabs — Sections de niveau supérieur avec une navigation horizontale en haut de votre site. Utilisez les onglets lorsque vous avez des domaines distincts comme API Reference et Guides.
• Anchors — Éléments persistants en haut de votre barre latérale. Utiles pour un accès rapide aux ressources externes ou aux sections de niveau supérieur. Peuvent être globaux pour apparaître sur chaque page.
• Dropdowns — Menus déroulants en haut de votre barre latérale. Alternative plus légère aux onglets pour plusieurs sections connexes.
• Menus — Éléments de navigation déroulants au sein d’un onglet pour des liens directs vers des pages spécifiques.
• Products — Un sélecteur pour plusieurs ensembles de documentation produit distincts, chacun avec sa propre structure de navigation.
• Versions — Un sélecteur pour plusieurs versions de documentation simultanées.
• Languages — Un sélecteur pour la documentation en plusieurs langues.

​

Configurer les éléments

Survolez n’importe quel élément de navigation et cliquez sur l’icône d’engrenage pour définir :

• Title : L’étiquette affichée dans la barre latérale.
• Icon : Un repère visuel à côté de l’étiquette.
• Tag : Un badge comme « NEW » ou « BETA » pour mettre en évidence l’élément.