Excluir archivos de la publicación
Excluye archivos y directorios específicos de tu documentación publicada usando un archivo .mintignore con patrones glob, similar a la sintaxis de .gitignore.
El archivo .mintignore te permite excluir archivos y directorios específicos en tu repositorio de documentación del procesamiento y la publicación en tu sitio de documentación.
Usa .mintignore para mantener borradores, notas internas y archivos fuente fuera de tu documentación pública mientras los sigues conservando en tu repositorio.
Crea un archivo .mintignore en la raíz de tu directorio de documentación. Este archivo utiliza la misma sintaxis de patrones que .gitignore.
# Excluir borradores de documentos
drafts/
*.draft.mdx
# Excluir documentación interna
internal/
# Excluir archivos específicos
private-notes.mdCuando Mintlify construye tu documentación, lee el archivo .mintignore y excluye del procesamiento cualquier archivo o directorio que coincida.
Archivos excluidos:
- No aparecen en tu documentación publicada.
- No se indexan en la búsqueda.
- No son accesibles para los visitantes.
- No tienen sus enlaces salientes verificados por
mint broken-links. - Hacen que cualquier enlace que apunte a ellos desde otras páginas aparezca como roto en las comprobaciones de
mint broken-links.
Mintlify ignora automáticamente los siguientes directorios y archivos sin requerir ninguna configuración:
.git.github.claude.agents.idea.vscodenode_modulesbuilddistcoverage.cachetmptempREADME.mdLICENSE.mdCHANGELOG.mdCONTRIBUTING.md
No necesitas añadirlos a tu archivo .mintignore.
A diferencia de las páginas ocultas, .mintignore elimina completamente los archivos coincidentes de tu sitio. Los visitantes no pueden acceder a ellos mediante una URL.
El archivo .mintignore sigue la sintaxis de .gitignore. Algunos patrones comunes son:
| Pattern | Descripción |
|---|---|
drafts/ | Excluye todo el directorio drafts |
*.draft.mdx | Excluye todos los archivos que terminan en .draft.mdx |
private-notes.md | Excluye un archivo específico |
**/internal/** | Excluye cualquier directorio internal en cualquier nivel |
!important.mdx | Anula un patrón anterior (incluye el archivo) |