Files
mintlify[bot] 6407b43ce9 Documentation quality check: close reader-question gaps (#6407)
* 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>
2026-07-07 13:18:35 -07:00

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>