You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: es/deploy/vercel.mdx
+38-27Lines changed: 38 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,53 +10,64 @@ import { VercelJsonGenerator } from "/snippets/es/vercel-json-generator.mdx";
10
10
## Archivo vercel.json
11
11
</div>
12
12
13
-
El archivo `vercel.json`define cómo se compila y se implementa tu proyecto. Se encuentra en el directorio raíz y controla varios aspectos de la implementación, incluidos el enrutamiento, las redirecciones, los encabezados y la configuración de compilación.
13
+
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, incluidos el enrutamiento, las redirecciones, los encabezados y los ajustes de compilación.
14
14
15
-
Usamos la opción `rewrites` para enrutar mediante proxy las solicitudes desde tu dominio principal hacia tu documentación.
15
+
Usamos la configuración de `rewrites` para enrutar mediante proxy las solicitudes desde tu domain principal hacia tu documentación.
16
16
17
-
Los `rewrites` reasignan las solicitudes entrantes a distintos destinos sin cambiar la URL en el navegador. Cuando alguien visita `yoursite.com/docs`, Vercel obtendrá internamente el contenido de `your-subdomain.mintlify.dev/docs`, pero el usuario seguirá viendo `yoursite.com/docs` en su navegador. Esto es diferente de las redirecciones, que enviarían a los usuarios a una URL completamente distinta.
17
+
Los 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 de `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.
18
18
19
-
Puedes personalizar la subruta con el valor que prefieras, como `/docs`, `/help` o `/guides`. Además, puedes usar subrutas profundamente anidadas, como `/product/docs`.
20
-
21
-
<divid="repository-structure">
22
-
## Estructura del repositorio
23
-
</div>
24
-
25
-
Tus archivos de documentación deben organizarse dentro de tu repositorio para que coincidan con la estructura de subruta que elijas. Por ejemplo, si quieres que tu documentación esté en `yoursite.com/docs`, deberías crear un directorio `docs/` con todos tus archivos de documentación.
19
+
Puedes personalizar la subruta con cualquier valor que prefieras, como `/docs`, `/help` o `/guides`. Además, puedes usar subrutas anidadas en varios niveles, como `/product/docs`.
26
20
27
21
<divid="configuration">
28
22
## Configuración
29
23
</div>
30
24
31
-
Para alojar tu documentación en una subruta personalizada con Vercel, añade la siguiente configuración a tu archivo `vercel.json`. Este ejemplo usa `/docs`, pero puedes reemplazarlo por cualquier subruta:
25
+
<divid="host-from-docs">
26
+
### Alojar desde `/docs`
27
+
</div>
28
+
29
+
1. Ve a [Configuración de dominio personalizado](https://dashboard.mintlify.com/settings/deployment/custom-domain) en tu dashboard.
30
+
2. Activa el interruptor **Host at `/docs`**.
31
+
32
+
<Frame>
33
+
<imgalt="Captura de pantalla de la página de Configuración de dominio personalizado. El interruptor Host at `/docs` está activado y resaltado por un rectángulo naranja."src="/images/subpath/toggle-light.png"className="block dark:hidden" />
34
+
35
+
<imgalt="Captura de pantalla de la página de Configuración de dominio personalizado. El interruptor Host at `/docs` está activado y resaltado por un rectángulo naranja."src="/images/subpath/toggle-dark.png"className="hidden dark:block" />
36
+
</Frame>
37
+
38
+
3. Ingresa tu domain.
39
+
4. Selecciona **Add domain**.
40
+
5. Agrega las siguientes reglas de reescritura a tu archivo `vercel.json`. Reemplaza `[subdomain]` con tu subdomain:
***`source`**: El patrón de ruta en tu domain que activa la reescritura.
49
-
***`destination`**: El destino al que se debe enviar la solicitud mediante proxy.
58
+
***`destination`**: El destino al que se debe enrutar la solicitud mediante proxy.
50
59
***`:match*`**: Un comodín que captura cualquier segmento de ruta después de tu subruta.
51
60
52
61
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.
53
62
54
63
55
-
<divid="generate-rewrites">
56
-
### Generar redirecciones
64
+
<divid="host-from-custom-path">
65
+
### Hospedar desde una ruta personalizada
57
66
</div>
58
67
59
-
Ingresa tu subdomain y subdirectorio personalizado para generar las redirecciones para tu archivo `vercel.json`.
68
+
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 esa subruta. Por ejemplo, si tu documentación se hospeda en `yoursite.com/help`, los archivos de la documentación deben estar en el directorio `help/`.
69
+
70
+
Usa el generador a continuación para crear la configuración de rewrites. Agrega los rewrites a tu archivo `vercel.json`.
El estilo del “eyebrow” de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta completa de navegación. De forma predeterminada es `section`.
138
+
Estilo del eyebrow de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta completa de navegación. De forma predeterminada es `section`.
Biblioteca de iconos para usar en toda tu documentación. De forma predeterminada es `fontawesome`.
199
+
Biblioteca de iconos que se usará en toda tu documentación. De forma predeterminada es `fontawesome`.
200
200
201
201
<Note>
202
202
Puedes especificar una URL a un icono alojado externamente, la ruta a un archivo de icono en tu proyecto o código SVG compatible con JSX para cualquier icono individual, independientemente de la configuración de la biblioteca.
@@ -206,81 +206,37 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
206
206
</ResponseField>
207
207
208
208
<ResponseFieldname="fonts"type="object">
209
-
Configuración tipográfica para tu documentación. La fuente predeterminada es [Inter](https://fonts.google.com/specimen/Inter).
209
+
Configuración de fuentes para los encabezados de tu documentación. La fuente predeterminada varía según el tema.
210
210
211
-
<Expandabletitle="Fuentes">
211
+
<Expandabletitle="Fonts">
212
212
<ResponseFieldname="family"type="string"required>
213
-
Familia tipográfica, por ejemplo,"Open Sans".
213
+
Familia tipográfica, como"Open Sans".
214
214
</ResponseField>
215
215
216
216
<ResponseFieldname="weight"type="number">
217
-
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
217
+
Peso de la fuente, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
218
218
</ResponseField>
219
219
220
220
<ResponseFieldname="source"type="string (uri)">
221
-
URL del archivo de tu fuente, por ejemplo, https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) se cargan automáticamente cuando especificas un nombre de `family` de Google Fonts, por lo que no se necesita una URL de fuente.
221
+
URL al origen de tu fuente, como https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) se carga automáticamente cuando especificas un nombre de `family` de Google Fonts, por lo que no se necesita una URL de origen.
Sobrescribe la configuración de la fuente específicamente para los encabezados.
230
-
231
-
<Expandabletitle="Encabezado">
232
-
<ResponseFieldname="family"type="string"required>
233
-
Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display".
234
-
</ResponseField>
235
-
236
-
<ResponseFieldname="weight"type="number">
237
-
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
238
-
</ResponseField>
239
-
240
-
<ResponseFieldname="source"type="string (uri)">
241
-
URL del archivo de tu fuente, por ejemplo, https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) se cargan automáticamente cuando especificas un nombre de `family` de Google Fonts, por lo que no se necesita una URL de fuente.
Sobrescribe la configuración de la fuente específicamente para el cuerpo del texto.
252
-
253
-
<Expandabletitle="Cuerpo">
254
-
<ResponseFieldname="family"type="string"required>
255
-
Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display".
256
-
</ResponseField>
257
-
258
-
<ResponseFieldname="weight"type="number">
259
-
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
260
-
</ResponseField>
261
-
262
-
<ResponseFieldname="source"type="string (uri)">
263
-
URL del archivo de tu fuente, por ejemplo, https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) se cargan automáticamente cuando especificas un nombre de `family` de Google Fonts, por lo que no se necesita una URL de fuente.
Modo de tema predeterminado. Elige `system` para ajustarlo a la configuración del sistema operativo del usuario, o `light` o `dark` para forzar un modo específico. De manera predeterminada es `system`.
235
+
Modo de tema predeterminado. Elige `system` para coincidir con la configuración del SO de los usuarios, o `light` o `dark` para forzar un modo específico. El valor predeterminado es `system`.
280
236
</ResponseField>
281
237
282
238
<ResponseFieldname="strict"type="boolean">
283
-
Indica si se debe ocultar el conmutador de modo claro/oscuro. De manera predeterminada es `true`.
239
+
Si se oculta el conmutador de modo claro/oscuro. El valor predeterminado es `true`.
Copy file name to clipboardExpand all lines: fr/deploy/vercel.mdx
+38-27Lines changed: 38 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,53 +10,64 @@ import { VercelJsonGenerator } from "/snippets/fr/vercel-json-generator.mdx";
10
10
## Fichier vercel.json
11
11
</div>
12
12
13
-
Le fichier `vercel.json` définit la manière dont votre projet est construit et déployé. Il se trouve à la racine de votre projet et contrôle divers aspects de votre déploiement, notamment le routage, les redirections, les en-têtes et les paramètres de build.
13
+
Le fichier `vercel.json` définit la façon dont votre projet est construit et déployé. Il se trouve à la racine de votre projet et contrôle divers aspects du déploiement, notamment le routage, les redirections, les en-têtes et les paramètres de build.
14
14
15
-
Nous utilisons la configuration `rewrites` pour faire transiter (proxy) les requêtes de votre domaine principal vers votre documentation.
15
+
Nous utilisons la configuration `rewrites` pour mettre en proxy les requêtes depuis votre domaine principal vers votre documentation.
16
16
17
-
Les réécritures redirigent les requêtes entrantes vers d’autres destinations sans modifier l’URL affichée dans le navigateur. Lorsque quelqu’un visite `yoursite.com/docs`, Vercel récupère en interne le contenu depuis `your-subdomain.mintlify.dev/docs`, mais l’utilisateur voit toujours `yoursite.com/docs` dans son navigateur. Cela diffère des redirections, qui enverraient les utilisateurs vers une autre URL.
17
+
Les réécritures font pointer les requêtes entrantes vers d’autres destinations sans changer l’URL dans le navigateur. Lorsque quelqu’un visite `yoursite.com/docs`, Vercel récupère en interne le contenu depuis `your-subdomain.mintlify.dev/docs`, mais l’utilisateur voit toujours `yoursite.com/docs` dans son navigateur. Cela diffère des redirections, qui envoient les utilisateurs vers une autre URL.
18
18
19
-
Vous pouvez personnaliser le sous-chemin avec la valeur de votre choix, comme `/docs`, `/help` ou `/guides`. Vous pouvez également utiliser des sous-chemins profondément imbriqués comme `/product/docs`.
20
-
21
-
<divid="repository-structure">
22
-
## Structure du référentiel
23
-
</div>
24
-
25
-
Vos fichiers de documentation doivent être organisés dans votre référentiel afin de correspondre à la structure de sous-chemin que vous avez choisie. Par exemple, si vous souhaitez que votre documentation se trouve à `yoursite.com/docs`, vous devez créer un répertoire `docs/` contenant tous vos fichiers de documentation.
19
+
Vous pouvez personnaliser le sous-chemin avec n’importe quelle valeur, comme `/docs`, `/help` ou `/guides`. Vous pouvez également utiliser des sous-chemins profondément imbriqués comme `/product/docs`.
26
20
27
21
<divid="configuration">
28
22
## Configuration
29
23
</div>
30
24
31
-
Pour héberger votre documentation à un sous-chemin personnalisé avec Vercel, ajoutez la configuration suivante à votre fichier `vercel.json`. Cet exemple utilise `/docs`, mais vous pouvez le remplacer par n’importe quel sous-chemin :
25
+
<divid="host-from-docs">
26
+
### Héberger depuis `/docs`
27
+
</div>
28
+
29
+
1. Accédez à la [configuration du domaine personnalisé](https://dashboard.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
30
+
2. Activez l’option **Héberger à `/docs`**.
31
+
32
+
<Frame>
33
+
<imgalt="Capture d’écran de la page de configuration du domaine personnalisé. L’option « Héberger à `/docs` » est activée et mise en évidence par un rectangle orange."src="/images/subpath/toggle-light.png"className="block dark:hidden" />
34
+
35
+
<imgalt="Capture d’écran de la page de configuration du domaine personnalisé. L’option « Héberger à `/docs` » est activée et mise en évidence par un rectangle orange."src="/images/subpath/toggle-dark.png"className="hidden dark:block" />
36
+
</Frame>
37
+
38
+
3. Renseignez votre domain.
39
+
4. Sélectionnez **Ajouter un domain**.
40
+
5. Ajoutez les réécritures suivantes à votre fichier `vercel.json`. Remplacez `[subdomain]` par votre sous-domaine :
***`source`**: Le modèle de chemin sur votre domain qui déclenche la réécriture.
49
-
***`destination`**: La destination vers laquelle la requête doit être mise en proxy.
58
+
***`destination`**: La cible vers laquelle la requête doit être mise en proxy.
50
59
***`:match*`**: Un caractère générique qui capture tous les segments de chemin après votre sous-chemin.
51
60
52
61
Pour en savoir plus, consultez [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) dans la documentation Vercel.
53
62
54
63
55
-
<divid="generate-rewrites">
56
-
### Générer des règles de réécriture
64
+
<divid="host-from-custom-path">
65
+
### Héberger depuis un chemin personnalisé
57
66
</div>
58
67
59
-
Saisissez votre sous-domaine et votre sous-répertoire personnalisé pour générer les règles de réécriture de votre fichier `vercel.json`.
68
+
Pour utiliser un sous-chemin personnalisé (tout chemin autre que `/docs`), vous devez organiser vos fichiers de documentation dans votre référentiel pour qu’ils correspondent à la structure de ce sous-chemin. Par exemple, si votre documentation est hébergée à `yoursite.com/help`, vos fichiers de documentation doivent se trouver dans un répertoire `help/`.
69
+
70
+
Utilisez le générateur ci-dessous pour créer votre configuration de réécriture. Ajoutez les règles de réécriture à votre fichier `vercel.json`.
![locadex-agent[bot]](https://avatars.githubusercontent.com/in/1436158?v=4&size=40){kind=avatar}
0 commit comments