mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
6407b43ce9
* docs: close reader-question gaps in recently changed pages * docs: translate reader-question gap fixes (es, fr, zh) * Apply suggestion from @ethanpalm * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Apply suggestion from @ethanpalm * Apply suggestion from @ethanpalm * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
110 lines
5.0 KiB
Plaintext
110 lines
5.0 KiB
Plaintext
---
|
|
title: "Exportación offline"
|
|
description: "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."
|
|
keywords: ["exportar", "offline", "zip", "sitio estático", "distribución", "mint export"]
|
|
---
|
|
|
|
<Info>
|
|
Las exportaciones offline requieren un [plan Enterprise](https://mintlify.com/pricing?ref=offline-export).
|
|
</Info>
|
|
|
|
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](https://nodejs.org).
|
|
|
|
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.
|
|
|
|
<div id="prerequisites">
|
|
## Requisitos previos
|
|
</div>
|
|
|
|
- La [CLI](/es/cli/install) instalada y actualizada
|
|
- [Node.js](https://nodejs.org) v20.17.0+ instalado
|
|
|
|
<div id="export-your-site">
|
|
## Exportar tu sitio
|
|
</div>
|
|
|
|
Navega al directorio de documentación que contiene tu archivo `docs.json` y ejecuta:
|
|
|
|
```bash
|
|
mint export
|
|
```
|
|
|
|
La 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.
|
|
|
|
<div id="options">
|
|
### Opciones
|
|
</div>
|
|
|
|
| Flag | Descripción | Predeterminado |
|
|
|---|---|---|
|
|
| `--output <path>` | Establece la ruta del archivo zip de salida. | `export.zip` |
|
|
| `--groups <group>` | Simula [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups) 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:
|
|
|
|
```bash
|
|
mint export --output customer-docs.zip --groups enterprise
|
|
```
|
|
|
|
<Note>
|
|
La exportación solo incluye las páginas listadas en tu navegación. Las [páginas ocultas](/es/organize/hidden-pages) no se incluyen en el archivo.
|
|
</Note>
|
|
|
|
<div id="security-considerations">
|
|
### Consideraciones de seguridad
|
|
</div>
|
|
|
|
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 `--groups` controla 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.
|
|
|
|
<div id="whats-in-the-zip">
|
|
## Qué contiene el zip
|
|
</div>
|
|
|
|
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 |
|
|
|
|
<div id="view-the-exported-docs">
|
|
## Ver la documentación exportada
|
|
</div>
|
|
|
|
Comparte el archivo zip con cualquier persona que tenga Node.js instalado. Para ver la documentación:
|
|
|
|
<Tabs>
|
|
<Tab title="Manual">
|
|
1. Descomprime el archivo.
|
|
2. Abre una terminal en el directorio descomprimido.
|
|
3. Ejecuta `node serve.js`.
|
|
4. Abre `http://localhost:3000` en tu navegador.
|
|
</Tab>
|
|
<Tab title="macOS">
|
|
1. Descomprime el archivo.
|
|
2. Haz doble clic en **Start Docs.command**.
|
|
3. La documentación se abre en tu navegador predeterminado en `http://localhost:3000`.
|
|
|
|
<Note>
|
|
macOS puede bloquear el archivo porque fue descargado de internet. Si ves una advertencia de seguridad, ve a **Configuración del Sistema > Privacidad y Seguridad** y selecciona **Abrir de todos modos**. Consulta la [guía de Apple para anular la configuración de seguridad](https://support.apple.com/guide/mac-help/mh40617/mac) para más detalles.
|
|
</Note>
|
|
</Tab>
|
|
<Tab title="Windows">
|
|
1. Descomprime el archivo.
|
|
2. Haz doble clic en **Start Docs.bat**.
|
|
3. La documentación se abre en tu navegador predeterminado en `http://localhost:3000`.
|
|
|
|
<Note>
|
|
Windows puede mostrar una advertencia "Windows protegió tu PC" porque el archivo fue descargado de internet. Selecciona **Más información** y luego selecciona **Ejecutar de todos modos**.
|
|
</Note>
|
|
</Tab>
|
|
</Tabs>
|