Skip to main content
Utilisez la propriété de navigation sdk pour générer des pages de référence pour vos bibliothèques SDK à partir des outils de documentation que vous exécutez déjà. Mintlify lit l’artefact de build de chaque outil et crée une page pour chaque classe, interface, module et fonction, avec les groupes de navigation, les liens entre les pages et l’indexation pour la recherche inclus.

​
Formats pris en charge

​
Générer un artefact

Exécutez votre outil de documentation avec un format de sortie lisible par machine. Si vous publiez déjà des docs générées depuis votre CI, il s’agit généralement de l’ajout d’un seul flag à la même commande.

​
Remplir automatiquement les pages SDK

Ajoutez une propriété sdk à un onglet dans votre docs.json. Mintlify analyse l’artefact et crée des groupes de navigation et des pages pour la bibliothèque.
​
string
requis
L’outil de documentation qui a produit l’artefact : typedoc, docfx, javadoc, sphinx ou phpdoc.
​
string
requis
Chemin relatif vers le fichier ou le répertoire de l’artefact dans votre dépôt de documentation, ou une URL HTTPS.
​
string
Le préfixe de chemin d’URL pour les pages générées. Par défaut, sdk-reference.
Ajoutez plusieurs onglets pour documenter plusieurs bibliothèques. Chaque onglet doit avoir un directory unique.
Ajoutez le répertoire de votre artefact à .mintignore afin que Mintlify traite les artefacts comme des entrées de build plutôt que de les publier comme des ressources statiques.

​
Utiliser des sources distantes

Définissez source sur une URL HTTPS pour récupérer l’artefact au moment du build au lieu de le committer dans votre dépôt de documentation. Les formats à fichier unique (typedoc, phpdoc) acceptent une URL de fichier directe. Les formats à répertoire (docfx, javadoc, sphinx) acceptent une archive zip. Les jars Javadoc publiés sur Maven Central fonctionnent sans reconditionnement :
Les artefacts distants ont une limite de téléchargement de 50 Mo et une limite de taille extraite de 200 Mo.

​
Maintenir les références à jour

Régénérez l’artefact chaque fois que votre SDK change. Un pattern courant est un job CI dans chaque dépôt de SDK qui exécute l’outil de documentation à chaque publication et, soit commite l’artefact dans votre dépôt de documentation, soit le téléverse vers une URL stable référencée par source.