Exportación offline
Exporta tu sitio de documentación como un archivo zip autocontenido para visualización sin conexión, distribución interna o alojamiento en entornos aislados.
Las exportaciones offline requieren un plan Enterprise.
Usa mint export para empaquetar todo tu sitio de documentación en un archivo zip autocontenido. Los destinatarios pueden descomprimirlo y ver la documentación en su navegador sin conexión a internet, sin una cuenta de Mintlify ni herramientas de compilación—solo necesitan tener instalado Node.js.
Esto es útil cuando necesitas distribuir documentación a usuarios que no pueden acceder a tu sitio en producción, como clientes on-premise, entornos aislados (air-gapped) o revisiones internas de cumplimiento.
Navega al directorio de documentación que contiene tu archivo docs.json y ejecuta:
mint exportLa CLI compila tu sitio, rastrea todas las páginas definidas en tu navegación y empaqueta el resultado en un archivo zip en tu directorio actual.
| Flag | Descripción | Predeterminado |
|---|---|---|
--output <path> | Establece la ruta del archivo zip de salida. | export.zip |
--groups <group> | Simula grupos de usuarios para la exportación. Útil cuando tu documentación usa control de acceso basado en grupos y quieres que el archivo incluya páginas restringidas. | — |
--disable-openapi | Omite la generación de archivos OpenAPI durante la exportación. Úsalo si tienes muchas especificaciones OpenAPI y quieres compilaciones más rápidas. | — |
Por ejemplo, para exportar tu sitio con un nombre de archivo personalizado y un grupo de usuarios específico:
mint export --output customer-docs.zip --groups enterpriseLa exportación solo incluye las páginas listadas en tu navegación. Las páginas ocultas no se incluyen en el archivo.
El archivo exportado es un paquete estático y sin autenticación. Cualquier persona que tenga el archivo zip puede ver todas las páginas que contiene.
- El flag
--groupscontrola qué páginas restringidas por grupo incluye Mintlify en el archivo al momento de exportar. No aplica autenticación después de la exportación. - Comparte los archivos únicamente con destinatarios autorizados a ver el contenido que contienen.
- Regenera y vuelve a distribuir el archivo para publicar nuevos cambios: los destinatarios que ejecuten un zip anterior seguirán viendo el contenido anterior.
El archivo exportado contiene todo lo necesario para ver tu documentación sin conexión:
| Archivo | Propósito |
|---|---|
| Páginas HTML | Versión pre-renderizada de cada página de tu navegación |
_next/static/ | CSS, JavaScript y otros recursos estáticos empaquetados |
serve.js | Servidor HTTP de Node.js sin dependencias que sirve el sitio |
Start Docs.command | Lanzador para macOS—haz doble clic para abrir la documentación |
Start Docs.bat | Lanzador para Windows—haz doble clic para abrir la documentación |
Comparte el archivo zip con cualquier persona que tenga Node.js instalado. Para ver la documentación:
- Descomprime el archivo.
- Abre una terminal en el directorio descomprimido.
- Ejecuta
node serve.js. - Abre
http://localhost:3000en tu navegador.