mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
086a2640e8
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
71 lines
3.8 KiB
Plaintext
71 lines
3.8 KiB
Plaintext
---
|
|
title: "Vercel"
|
|
description: "Implementa la documentación en una subruta en Vercel."
|
|
keywords: ["vercel.json", "implementación en Vercel", "configuración de rewrites", "enrutamiento de subrutas"]
|
|
---
|
|
|
|
import { VercelJsonGenerator } from "/snippets/es/vercel-json-generator.mdx";
|
|
|
|
Configura tu archivo `vercel.json` para reenviar mediante un proxy las solicitudes desde tu dominio principal a tu documentación en una subruta.
|
|
|
|
|
|
<div id="verceljson-file">
|
|
## Archivo vercel.json
|
|
</div>
|
|
|
|
El archivo `vercel.json` configura cómo se compila e implementa tu proyecto. Se encuentra en el directorio raíz de tu proyecto y controla varios aspectos de la implementación, como el enrutamiento, las redirecciones, los encabezados y la configuración de compilación.
|
|
|
|
Usamos la configuración de `rewrites` en tu archivo `vercel.json` para enrutar las solicitudes desde tu dominio principal hacia tu documentación mediante un proxy.
|
|
|
|
Las reglas de reescritura (rewrites) asignan las solicitudes entrantes a distintos destinos sin cambiar la URL en el navegador. Cuando alguien visita `yoursite.com/docs`, Vercel obtiene internamente el contenido desde `your-subdomain.mintlify.dev/docs`, pero el usuario sigue viendo `yoursite.com/docs` en su navegador. Esto es diferente de las redirecciones, que envían a los usuarios a otra URL por completo.
|
|
|
|
<div id="configuration">
|
|
## Configuración
|
|
</div>
|
|
|
|
<div id="host-at-docs-subpath">
|
|
### Alojar en la subruta `/docs`
|
|
</div>
|
|
|
|
1. Navega a [Custom domain setup](https://dashboard.mintlify.com/settings/deployment/custom-domain) en tu dashboard.
|
|
2. Haz clic en el interruptor **Host at `/docs`** para activarlo.
|
|
<Frame>
|
|
<img alt="Captura de pantalla de la página Custom domain setup. El interruptor Host at `/docs` está activado y resaltado con un rectángulo naranja." src="/images/subpath/toggle-light.png" className="block dark:hidden" />
|
|
<img alt="Captura de pantalla de la página Custom domain setup. El interruptor Host at `/docs` está activado y resaltado con un rectángulo naranja." src="/images/subpath/toggle-dark.png" className="hidden dark:block" />
|
|
</Frame>
|
|
3. Ingresa tu dominio.
|
|
4. Selecciona **Add domain**.
|
|
5. Agrega las siguientes reglas de reescritura a tu archivo `vercel.json`. Sustituye `[subdomain]` por tu subdominio, que se encuentra al final de la URL de tu dashboard. Por ejemplo, `dashboard.mintlify.com/your-organization/your-subdomain` tiene un identificador de dominio de `your-subdomain`.
|
|
|
|
```json
|
|
{
|
|
"rewrites": [
|
|
{
|
|
"source": "/docs",
|
|
"destination": "https://[subdomain].mintlify.dev/docs"
|
|
},
|
|
{
|
|
"source": "/docs/:match*",
|
|
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
La configuración de `rewrites` asigna la subruta `/docs` en tu dominio a la subruta `/docs` en tu documentación.
|
|
|
|
- **`source`**: El patrón de ruta en tu dominio que activa la reescritura.
|
|
- **`destination`**: Adonde se debe enviar la solicitud mediante proxy.
|
|
- **`:match*`**: Un comodín que captura cualquier segmento de ruta después de tu subruta.
|
|
|
|
Para obtener más información, consulta [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) en la documentación de Vercel.
|
|
|
|
<div id="host-at-custom-subpath">
|
|
### Hospedar en una subruta personalizada
|
|
</div>
|
|
|
|
Para usar una subruta personalizada (cualquier ruta distinta de `/docs`), debes organizar los archivos de tu documentación dentro de tu repositorio para que coincidan con la estructura de la subruta. Por ejemplo, si tu documentación se aloja en `yoursite.com/help`, los archivos de tu documentación deben estar en un directorio `help/`.
|
|
|
|
Utiliza el generador a continuación para crear tu configuración de `rewrites`. Añade estas reglas de `rewrites` a tu archivo `vercel.json`.
|
|
|
|
<VercelJsonGenerator /> |