Skip to content

feat(locadex): continuous i18n #1491

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 7, 2025
Merged

feat(locadex): continuous i18n #1491

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 38 additions & 27 deletions es/deploy/vercel.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,53 +10,64 @@ import { VercelJsonGenerator } from "/snippets/es/vercel-json-generator.mdx";
## Archivo vercel.json
</div>

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.
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.

Usamos la opción `rewrites` para enrutar mediante proxy las solicitudes desde tu dominio principal hacia tu documentación.
Usamos la configuración de `rewrites` para enrutar mediante proxy las solicitudes desde tu domain principal hacia tu documentación.

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.
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.

Puedes personalizar la subruta con el valor que prefieras, como `/docs`, `/help` o `/guides`. Además, puedes usar subrutas profundamente anidadas, como `/product/docs`.

<div id="repository-structure">
## Estructura del repositorio
</div>

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.
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`.

<div id="configuration">
## Configuración
</div>

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:
<div id="host-from-docs">
### Alojar desde `/docs`
</div>

1. Ve a [Configuración de dominio personalizado](https://dashboard.mintlify.com/settings/deployment/custom-domain) en tu dashboard.
2. Activa el interruptor **Host at `/docs`**.

<Frame>
<img alt="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" />

<img alt="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" />
</Frame>

3. Ingresa tu domain.
4. Selecciona **Add domain**.
5. Agrega las siguientes reglas de reescritura a tu archivo `vercel.json`. Reemplaza `[subdomain]` con tu subdomain:

```json
{
"rewrites": [
{
"source": "/docs",
"destination": "https://[subdomain].mintlify.dev/docs"
},
{
"source": "/docs/:match*",
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
}
]
}
{
"rewrites": [
{
"source": "/docs",
"destination": "https://[subdomain].mintlify.dev/docs"
},
{
"source": "/docs/:match*",
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
}
]
}
```

* **`source`**: El patrón de ruta en tu domain que activa la reescritura.
* **`destination`**: El destino al que se debe enviar la solicitud mediante proxy.
* **`destination`**: El destino al que se debe enrutar 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="generate-rewrites">
### Generar redirecciones
<div id="host-from-custom-path">
### Hospedar desde una ruta personalizada
</div>

Ingresa tu subdomain y subdirectorio personalizado para generar las redirecciones para tu archivo `vercel.json`.
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/`.

Usa el generador a continuación para crear la configuración de rewrites. Agrega los rewrites a tu archivo `vercel.json`.

<VercelJsonGenerator />

Expand Down
74 changes: 15 additions & 59 deletions es/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,24 +135,24 @@ Esta sección contiene la referencia completa del archivo `docs.json`.

<Expandable title="Styling">
<ResponseField name="eyebrows" type="&#x22;section&#x22; | &#x22;breadcrumbs&#x22;">
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`.
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`.
</ResponseField>

<ResponseField name="codeblocks" type="&#x22;system&#x22; | &#x22;dark&#x22; | string | object">
Configuración del tema de los bloques de código. De forma predeterminada es `"system"`.
Configuración del tema de los bloques de código. El valor predeterminado es `"system"`.

**Configuración simple:**

* `"system"`: Coincidir con el modo actual del sitio (claro u oscuro)
* `"dark"`: Usar siempre el modo oscuro
* `"system"`: Coincide con el modo actual del sitio (claro u oscuro)
* `"dark"`: Usa siempre el modo oscuro

**Configuración de tema personalizada:**

* Usa una cadena para especificar un único [tema de Shiki](https://shiki.style/themes) para todos los bloques de código
* Usa un objeto para especificar [temas de Shiki](https://shiki.style/themes) separados para los modos claro y oscuro
* Usa un objeto para especificar [temas de Shiki](https://shiki.style/themes) distintos para los modos claro y oscuro

<ResponseField name="theme" type="string">
Un único nombre de tema de Shiki para usar tanto en modo claro como oscuro.
Un único nombre de tema de Shiki para usar en ambos modos, claro y oscuro.

```json
"styling": {
Expand Down Expand Up @@ -196,7 +196,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.

<Expandable title="Icons">
<ResponseField name="library" type="&#x22;fontawesome&#x22; | &#x22;lucide&#x22;" required>
Biblioteca de iconos para usar en toda tu documentación. De forma predeterminada es `fontawesome`.
Biblioteca de iconos que se usará en toda tu documentación. De forma predeterminada es `fontawesome`.

<Note>
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.
Expand All @@ -206,81 +206,37 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="fonts" type="object">
Configuración tipográfica para tu documentación. La fuente predeterminada es [Inter](https://fonts.google.com/specimen/Inter).
Configuración de fuentes para los encabezados de tu documentación. La fuente predeterminada varía según el tema.

<Expandable title="Fuentes">
<Expandable title="Fonts">
<ResponseField name="family" type="string" required>
Familia tipográfica, por ejemplo, &quot;Open Sans&quot;.
Familia tipográfica, como &quot;Open Sans&quot;.
</ResponseField>

<ResponseField name="weight" type="number">
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
Peso de la fuente, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
</ResponseField>

<ResponseField name="source" type="string (uri)">
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.
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.
</ResponseField>

<ResponseField name="format" type="&#x22;woff&#x22; | &#x22;woff2&#x22;">
Formato del archivo de fuente.
</ResponseField>

<ResponseField name="heading" type="object">
Sobrescribe la configuración de la fuente específicamente para los encabezados.

<Expandable title="Encabezado">
<ResponseField name="family" type="string" required>
Familia tipográfica, por ejemplo, &quot;Open Sans&quot;, &quot;Playfair Display&quot;.
</ResponseField>

<ResponseField name="weight" type="number">
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
</ResponseField>

<ResponseField name="source" type="string (uri)">
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.
</ResponseField>

<ResponseField name="format" type="&#x22;woff&#x22; | &#x22;woff2&#x22;">
Formato del archivo de fuente.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="body" type="object">
Sobrescribe la configuración de la fuente específicamente para el cuerpo del texto.

<Expandable title="Cuerpo">
<ResponseField name="family" type="string" required>
Familia tipográfica, por ejemplo, &quot;Open Sans&quot;, &quot;Playfair Display&quot;.
</ResponseField>

<ResponseField name="weight" type="number">
Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550.
</ResponseField>

<ResponseField name="source" type="string (uri)">
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.
</ResponseField>

<ResponseField name="format" type="&#x22;woff&#x22; | &#x22;woff2&#x22;">
Formato del archivo de fuente.
</ResponseField>
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="appearance" type="object">
Configuración del conmutador de modo claro/oscuro.

<Expandable title="Apariencia">
<Expandable title="Appearance">
<ResponseField name="default" type="&#x22;system&#x22; | &#x22;light&#x22; | &#x22;dark&#x22;">
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`.
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`.
</ResponseField>

<ResponseField name="strict" type="boolean">
Indica si se debe ocultar el conmutador de modo claro/oscuro. De manera predeterminada es `true`.
Si se oculta el conmutador de modo claro/oscuro. El valor predeterminado es `true`.
</ResponseField>
</Expandable>
</ResponseField>
Expand Down
65 changes: 38 additions & 27 deletions fr/deploy/vercel.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,53 +10,64 @@ import { VercelJsonGenerator } from "/snippets/fr/vercel-json-generator.mdx";
## Fichier vercel.json
</div>

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.
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.

Nous utilisons la configuration `rewrites` pour faire transiter (proxy) les requêtes de votre domaine principal vers votre documentation.
Nous utilisons la configuration `rewrites` pour mettre en proxy les requêtes depuis votre domaine principal vers votre documentation.

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.
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.

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`.

<div id="repository-structure">
## Structure du référentiel
</div>

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.
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`.

<div id="configuration">
## Configuration
</div>

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 :
<div id="host-from-docs">
### Héberger depuis `/docs`
</div>

1. Accédez à la [configuration du domaine personnalisé](https://dashboard.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
2. Activez l’option **Héberger à `/docs`**.

<Frame>
<img alt="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" />

<img alt="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" />
</Frame>

3. Renseignez votre domain.
4. Sélectionnez **Ajouter un domain**.
5. Ajoutez les réécritures suivantes à votre fichier `vercel.json`. Remplacez `[subdomain]` par votre sous-domaine :

```json
{
"rewrites": [
{
"source": "/docs",
"destination": "https://[subdomain].mintlify.dev/docs"
},
{
"source": "/docs/:match*",
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
}
]
}
{
"rewrites": [
{
"source": "/docs",
"destination": "https://[subdomain].mintlify.dev/docs"
},
{
"source": "/docs/:match*",
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
}
]
}
```

* **`source`**: Le modèle de chemin sur votre domain qui déclenche la réécriture.
* **`destination`**: La destination vers laquelle la requête doit être mise en proxy.
* **`destination`**: La cible vers laquelle la requête doit être mise en proxy.
* **`:match*`**: Un caractère générique qui capture tous les segments de chemin après votre sous-chemin.

Pour en savoir plus, consultez [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) dans la documentation Vercel.


<div id="generate-rewrites">
### Générer des règles de réécriture
<div id="host-from-custom-path">
### Héberger depuis un chemin personnalisé
</div>

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`.
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/`.

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`.

<VercelJsonGenerator />

Expand Down
Loading