Skip to content
Mintlify
Mintlify
Organiser

Exclure des fichiers de la publication

Excluez des fichiers et répertoires de votre documentation publiée à l'aide d'un fichier .mintignore avec des motifs glob, comme .gitignore.

Le fichier .mintignore vous permet d’exclure des fichiers et des répertoires spécifiques de votre référentiel de documentation du traitement et de la publication sur votre site de documentation.

Utilisez .mintignore pour conserver les brouillons, les notes internes et les fichiers source en dehors de votre documentation publique tout en les gardant dans votre référentiel.

Créez un fichier .mintignore à la racine de votre répertoire de documentation. Ce fichier utilise la même syntaxe de motifs que .gitignore.

.mintignore
# Exclure les documents brouillons
drafts/
*.draft.mdx

# Exclure la documentation interne
internal/

# Exclure des fichiers spécifiques
private-notes.md

Lorsque Mintlify génère votre documentation, il lit le fichier .mintignore et exclut de la génération tous les fichiers ou répertoires correspondants.

Fichiers exclus :

  • n’apparaissent pas dans votre documentation publiée ;
  • ne sont pas indexés pour la recherche ;
  • ne sont pas accessibles aux visiteurs ;
  • leurs liens sortants ne sont pas vérifiés par mint broken-links ;
  • ils font apparaître comme rompus tous les liens qui pointent vers eux depuis d’autres pages lors des contrôles de mint broken-links.

Mintlify ignore automatiquement les répertoires et fichiers suivants sans nécessiter de configuration :

  • .git
  • .github
  • .claude
  • .agents
  • .idea
  • .vscode
  • node_modules
  • build
  • dist
  • coverage
  • .cache
  • tmp
  • temp
  • README.md
  • LICENSE.md
  • CHANGELOG.md
  • CONTRIBUTING.md

Vous n’avez pas besoin de les ajouter à votre fichier .mintignore.

Contrairement aux pages masquées, .mintignore supprime entièrement les fichiers correspondants de votre site. Les visiteurs ne peuvent pas y accéder via leur URL.

Le fichier .mintignore utilise la même syntaxe que .gitignore. Voici quelques motifs courants :

MotifDescription
drafts/Exclut l’intégralité du répertoire drafts
*.draft.mdxExclut tous les fichiers se terminant par .draft.mdx
private-notes.mdExclut un fichier spécifique
**/internal/**Exclut tout répertoire internal, quel que soit son niveau
!important.mdxAnnule un motif précédent (inclut le fichier)
Was this page helpful?Suggest editsRaise issue