mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
c5f290b1f8
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
26 lines
6.5 KiB
Plaintext
26 lines
6.5 KiB
Plaintext
{/* vale off */}
|
|
|
|
<Prompt description="Copiez-collez ce prompt pour que votre agent configure votre site Mintlify." actions={["copy", "cursor"]}>
|
|
Mettez ma documentation en ligne sur un site Mintlify publié. Vous avez terminé avec succès lorsque vous me donnez l'URL en direct et confirmez qu'elle se charge. Dites-moi clairement chaque fois qu'une étape nécessite mon intervention—faites tout le reste vous-même. Si ce prompt a déjà été collé (par exemple, après un redémarrage), reprenez là où vous vous étiez arrêté au lieu de recommencer depuis le début. Si vous n'avez pas accès au terminal ou à l'exécution de commandes, dites-moi de suivre les étapes manuelles sur [mintlify.com/start](https://mintlify.com/start) à la place. Tout ce qui suit nécessite d'exécuter des commandes et requiert Node.js v 20.17.0+ (les versions LTS sont recommandées).
|
|
|
|
1. Demandez-moi le contenu existant qui sera utilisé pour mon site Mintlify. Il peut s'agir d'un dossier local ou d'un référentiel. Vérifiez la source avant de construire : reproduisez exactement ce que vous lisez et listez son contenu de niveau supérieur afin que je puisse confirmer qu'il est correct. Si vous ne pouvez pas accéder à quelque chose que j'ai indiqué (les référentiels privés renvoient 404, tout comme ceux qui n'existent pas), arrêtez-vous et demandez. Ne substituez jamais une autre source.
|
|
2. Vérifiez si `mint` est installé avec `mint --version`. S'il est absent, installez-le avec `npm i -g mint` (ou `pnpm add -g mint`). S'il est déjà installé, exécutez `mint update` au lieu de le réinstaller.
|
|
3. Exécutez `mint status`. S'il affiche déjà une organisation, passez à l'étape 7.
|
|
4. Nécessite mon intervention : si `mint status` indique que je ne suis pas connecté, demandez-moi directement si j'ai déjà un compte Mintlify. Ne le devinez pas.
|
|
- Si j'en ai un : exécutez `mint login`. Vous avez besoin de moi pour les étapes du navigateur et pour approuver l'accès.
|
|
- Si je n'en ai pas : demandez-moi mon prénom, mon nom, mon entreprise et mon adresse e-mail si je ne vous les ai pas déjà donnés—ne les inventez jamais. Exécutez `mint signup --firstName [firstName] --lastName [lastName] --company [company] --email [email]` en tâche de fond car cette commande se bloque jusqu'à ce que je clique sur un lien de vérification qui peut prendre plusieurs minutes.
|
|
5. Nécessite mon intervention : je vais consulter mon e-mail et cliquer sur le lien de vérification. Cela ouvre un onglet du navigateur qui finalise automatiquement le reste de la création du compte / de la connexion. Je dois approuver la CLI, puis connecter un référentiel GitHub ou laisser Mintlify en héberger un. Dites-moi clairement que cette étape m'incombe, puis attendez qu'elle soit terminée avant de continuer.
|
|
6. Exécutez `mint status` à nouveau pour confirmer qu'une organisation et un sous-domaine existent désormais. Le provisionnement peut prendre un moment après la fin de l'onboarding — si aucun sous-domaine n'apparaît encore, attendez environ 10 secondes et réessayez plusieurs fois avant de conclure qu'il y a un problème.
|
|
7. Nécessite mon intervention : demandez-moi l'URL du référentiel connecté à mon projet Mintlify — `mint status` ne l'expose pas, vous ne pouvez donc pas la trouver vous-même. Clonez-le une fois que je vous l'aurai donnée.
|
|
8. Vérifiez ce qui se trouve dans ce référentiel. Si j'ai connecté mon propre référentiel de documentation existant, mon contenu s'y trouve déjà — ne l'écrasez pas. Si Mintlify a créé le référentiel, il contient du contenu de modèle de démarrage — remplacez-le par le contenu réel de ma documentation issu de l'étape 1. N'utilisez `mint new [répertoire]` que si je veux un thème ou un modèle différent de celui présent dans le référentiel — générez-le localement, puis utilisez sa sortie à la place du contenu préchargé.
|
|
9. Prévisualisez avec `mint dev`, qui démarre généralement sur `http://localhost:3000`, sauf si ce port est déjà utilisé. La commande se bloque jusqu'à ce qu'elle soit arrêtée, exécutez-la donc en tâche de fond. Vérifiez que la prévisualisation se charge, puis arrêtez-la avant de continuer.
|
|
10. Faites un commit et un push de vos changements. Mintlify se déploie automatiquement lors du push.
|
|
11. Nécessite mon intervention : si je veux un domaine personnalisé, exécutez `mint add-domain <domaine>`. Cette commande imprime les enregistrements DNS que je dois ajouter chez mon fournisseur de domaine. Indiquez-moi les enregistrements DNS, car moi seul peux les configurer chez mon bureau d'enregistrement. Précisez clairement qu'il s'agit d'une étape que je dois effectuer.
|
|
12. Confirmez que mon site est en ligne : récupérez `https://<sous-domaine>.mintlify.site` (trouvez le sous-domaine via `mint status`) et confirmez qu'il se charge. Si j'ai ajouté un domaine personnalisé à l'étape 11, récupérez également ce domaine et confirmez qu'il se charge avant de considérer cette étape comme terminée — la propagation DNS peut prendre du temps, réessayez donc plusieurs fois avant de considérer un échec de récupération comme une erreur.
|
|
13. Préparez-vous à continuer à travailler ici : installez la [skill Mintlify](https://mintlify.com/docs/ai/skillmd.md) avec `npx skills add https://mintlify.com/docs`, puis enregistrez le [serveur MCP d'administration](https://mintlify.com/docs//ai/model-context-protocol.md) à l'adresse `https://mcp.mintlify.com` pour votre outil spécifique. Par exemple, `claude mcp add --transport http mintlify https://mcp.mintlify.com` pour Claude Code, ou récupérez https://mintlify.com/docs/ai/mintlify-mcp.md pour obtenir les instructions pour Claude, Cursor, Codex ou ChatGPT. Faites cette étape vous-même—ne me demandez pas d'exécuter ces commandes.
|
|
14. Nécessite mon intervention : le premier appel d'outil MCP d'administration ouvre une fenêtre du navigateur pour la connexion OAuth. Approuvez-la là. La plupart des outils ne chargent pas les serveurs MCP nouvellement ajoutés en cours de session — si les outils Mintlify n'apparaissent pas, dites-moi de vous redémarrer et nous reprendrons ici.
|
|
15. Si une commande échoue d'une manière non couverte ci-dessus, arrêtez-vous et donnez-moi l'erreur exacte au lieu de deviner ou de réessayer à l'aveugle. S'il semble que le problème vient du côté de Mintlify plutôt que de ce que vous faites, consultez https://status.mintlify.com ou renvoyez-moi vers https://mintlify.com/docs/contact-support.
|
|
</Prompt>
|
|
|
|
{/* vale on */}
|