mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
97c7639c35
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
115 lines
3.9 KiB
Plaintext
115 lines
3.9 KiB
Plaintext
---
|
|
title: "Previsualización local"
|
|
description: "Ejecuta una previsualización local de tu sitio Mintlify con recarga en vivo, búsqueda de texto completo y soporte de assistant usando mint dev."
|
|
keywords: ["mint dev", "previsualización local", "localhost", "mint login", "búsqueda", "asistente"]
|
|
---
|
|
|
|
<div id="prerequisites">
|
|
## Requisitos previos
|
|
</div>
|
|
|
|
- La [CLI de Mintlify](/es/cli/install) instalada globalmente, o ejecuta los comandos con `npx mint`.
|
|
- Un directorio de documentación con un archivo `docs.json` válido.
|
|
|
|
<div id="start-the-local-preview">
|
|
## Iniciar la previsualización local
|
|
</div>
|
|
|
|
Navega al directorio de tu documentación que contiene el archivo `docs.json` y ejecuta:
|
|
|
|
```bash
|
|
mint dev
|
|
```
|
|
|
|
La previsualización local se inicia en `http://localhost:3000`. A medida que editas, los cambios aparecen en tiempo real.
|
|
|
|
Por defecto, la previsualización se abre automáticamente en tu navegador. Para evitar que el navegador se abra, usa el flag `--no-open`:
|
|
|
|
```bash
|
|
mint dev --no-open
|
|
```
|
|
|
|
Para generar una previsualización sin instalar la CLI globalmente, ejecuta:
|
|
|
|
```bash
|
|
npx mint dev
|
|
```
|
|
|
|
<Tip>
|
|
Si escribes en VS Code o Cursor, la [extensión Mintlify MDX](/es/cli/mdx-extension) ejecuta esta previsualización en un panel junto a tu editor y la desplaza para coincidir con la página que estás editando.
|
|
</Tip>
|
|
|
|
<div id="log-in-for-search-and-assistant">
|
|
## Iniciar sesión para búsqueda y asistente
|
|
</div>
|
|
|
|
Debes autenticar la CLI con tu cuenta de Mintlify para habilitar la búsqueda y el [asistente](/es/assistant/index).
|
|
|
|
```bash
|
|
mint login
|
|
```
|
|
|
|
Después de autenticarte con el comando `mint login`, la CLI almacena tus credenciales en `~/.config/mintlify/config.json` para que permanezcas conectado entre sesiones. La CLI también te solicita que selecciones un proyecto predeterminado, que comandos como `mint automations` utilizan.
|
|
|
|
Una vez que hayas iniciado sesión, ejecuta `mint dev` para iniciar la previsualización local con la búsqueda y el asistente habilitados. El asistente usa el mismo contenido indexado que tu sitio de documentación desplegado.
|
|
|
|
Para verificar el estado de tu autenticación, ejecuta:
|
|
|
|
```bash
|
|
mint status
|
|
```
|
|
|
|
Para cerrar sesión, ejecuta:
|
|
|
|
```bash
|
|
mint logout
|
|
```
|
|
|
|
<div id="custom-ports">
|
|
## Puertos personalizados
|
|
</div>
|
|
|
|
Por defecto, la CLI usa el puerto 3000. Para usar un puerto diferente, usa el flag `--port`:
|
|
|
|
```bash
|
|
mint dev --port 3333
|
|
```
|
|
|
|
Si el puerto ya está en uso, la CLI intenta automáticamente el siguiente puerto disponible.
|
|
|
|
<div id="skip-openapi-processing">
|
|
## Omitir el procesamiento de OpenAPI
|
|
</div>
|
|
|
|
Si tienes muchos archivos OpenAPI, omite el procesamiento de OpenAPI durante el desarrollo local para mejorar el rendimiento con el flag `--disable-openapi`:
|
|
|
|
```bash
|
|
mint dev --disable-openapi
|
|
```
|
|
|
|
<div id="disable-navigation-prefetching">
|
|
## Deshabilitar la precarga de navegación
|
|
</div>
|
|
|
|
De forma predeterminada, la vista previa local precarga las páginas cercanas para que la navegación entre ellas se sienta instantánea. En sitios muy grandes, esto puede ralentizar la página que estás viendo, porque muchas páginas se compilan en segundo plano al mismo tiempo.
|
|
|
|
Si tienes miles de páginas y notas cargas de página lentas durante la vista previa local, deshabilita la precarga con el flag `--disable-prefetch`:
|
|
|
|
```bash
|
|
mint dev --disable-prefetch
|
|
```
|
|
|
|
Con la precarga deshabilitada, las páginas se compilan solo cuando navegas a ellas. Las cargas de página individuales tardan más que una página precargada, pero la página que solicitas no compite con la compilación en segundo plano.
|
|
|
|
<div id="preview-as-a-specific-group">
|
|
## Previsualizar como un grupo específico
|
|
</div>
|
|
|
|
Si usas control de acceso basado en grupos, previsualiza como un grupo de autenticación específico con el flag `--groups`:
|
|
|
|
```bash
|
|
mint dev --groups admin
|
|
```
|
|
|
|
Consulta [Configuración de autenticación](/es/deploy/authentication-setup#control-access-with-groups) para más información sobre grupos.
|