Configuration d’un monorepo
Configurez le chemin de la documentation et le répertoire de contenu dans un monorepo afin que Mintlify déploie uniquement votre dossier de docs désigné.
Configurez Mintlify pour déployer la documentation depuis un répertoire spécifique au sein d’un monorepo. Cette configuration vous permet de conserver la documentation aux côtés de votre code dans des référentiels contenant plusieurs projets ou services.
Un déploiement monorepo utilise un seul dépôt avec un sous-répertoire de docs. Pour combiner le contenu de plusieurs dépôts dans un seul site, consultez Déploiements multi-référentiels.
Une structure de monorepo typique pourrait ressembler à ceci :
your-repo/
├── apps/
│ ├── web/
│ └── api/
├── docs/
│ ├── docs.json
│ └── quickstart.mdx
└── package.jsonDans cet exemple, vous définiriez le chemin de votre documentation sur /docs.
- Accès administrateur à votre projet Mintlify.
- Fichiers de documentation organisés dans un répertoire dédié au sein de votre monorepo.
- Un fichier
docs.jsonvalide dans votre répertoire de documentation.
Définir le chemin de votre documentation
- Activez l’option docs.json is in a subdirectory.
- Saisissez le chemin relatif vers votre répertoire de documentation. Par exemple, si votre documentation se trouve dans le répertoire
docs, saisissez/docs.
N’incluez pas de barre oblique finale dans le chemin.
- Sélectionnez Enregistrer les modifications. L’enregistrement déclenche un nouveau déploiement à partir du chemin configuré.