Organisations, déploiements et sites
.mintlify.site. Vous pouvez connecter un domaine personnalisé à votre site. Les sites incluent votre contenu, votre navigation, la recherche et toutes les fonctionnalités que vous activez, comme l’assistant ou le playground d’API.
La documentation utilise parfois projet comme nom générique pour un déploiement et son référentiel, sa configuration et son site associés.
Le référentiel est la source de vérité
- Les pages sont des fichiers
.mdx. Chaque page contient du contenu et des métadonnées de frontmatter. docs.jsonest le fichier de configuration obligatoire. Il contrôle la navigation, l’apparence, les intégrations, les paramètres d’API et d’autres comportements applicables à l’ensemble du site.- Les ressources incluent les images, vidéos, polices et fichiers téléchargeables référencés par vos pages.
- Les spécifications d’API peuvent générer des pages de référence d’API et des playgrounds interactifs à partir de schémas OpenAPI, AsyncAPI ou GraphQL.
- Les fichiers réutilisables incluent les snippets et les composants React personnalisés que les pages peuvent importer.
docs.json, sinon elle est masquée. Les pages masquées ne sont accessibles que par un lien direct.
Une page fournit le contenu à une URL. Son frontmatter contrôle les métadonnées et le comportement au niveau de la page, notamment son titre, sa description, son icône et sa mise en page.
La navigation détermine la façon dont les lecteurs se déplacent d’une page à l’autre. Configurez la navigation dans votre fichier docs.json en utilisant des éléments tels que les groupes, les onglets, les listes déroulantes, les produits, les versions et les langues. Le chemin du fichier identifie une page et sa position dans docs.json détermine son emplacement dans la navigation.
Cette séparation vous permet de réorganiser l’expérience du lecteur sans déplacer les fichiers. Elle vous permet également d’exclure les pages utilitaires de la navigation tout en les gardant accessibles par URL.
L’édition et la publication sont des étapes distinctes
Dans l’éditeur, les modifications sont enregistrées automatiquement mais ne mettent pas immédiatement à jour votre référentiel ou votre site en ligne. Lorsque vous publiez, l’éditeur écrit les modifications dans Git. Ce qui se passe ensuite dépend de votre branche actuelle et des paramètres de protection de branche.
- Sur la branche de déploiement, la publication peut déclencher directement un build du site en ligne.
- Sur une branche de fonctionnalité, la publication peut enregistrer les modifications sur la branche ou créer une pull request pour relecture.
- Un déploiement de prévisualisation rend une pull request sur une URL temporaire afin que les relecteurs puissent inspecter le résultat avant la fusion.
- La fusion d’une pull request dans la branche de déploiement déclenche un déploiement en production.
Un build transforme les fichiers source en expériences pour les lecteurs
- Le site de documentation affiche les pages pour les personnes sur ordinateur et mobile.
- La recherche indexe le site afin que les lecteurs puissent trouver les pages pertinentes.
- L’assistant répond aux questions à partir de la documentation et cite ses sources.
- Les versions Markdown des pages,
llms.txtetskill.mdaident les outils d’IA à comprendre le contenu. - Un serveur MCP public permet aux outils d’IA compatibles de récupérer la documentation sous forme de contexte structuré.
mint validate et mint broken-links avant de publier pour détecter les problèmes courants en local.