Skip to content

feat(locadex): continuous i18n #1923

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
Nov 26, 2025
Merged

feat(locadex): continuous i18n #1923

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
110 changes: 89 additions & 21 deletions es/api-playground/mdx-setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
---
title: "Crear páginas de API manualmente"
description: "Documenta endpoints de API manualmente con archivos MDX."
title: "Crear páginas de API manuales"
description: "Documenta endpoints de la API manualmente con archivos MDX."
keywords: ["Documentación de API", "Documentación de endpoints"]
---

Puedes definir endpoints de API manualmente en páginas individuales. Este enfoque es útil para API pequeñas o para prototipos.
Puedes definir endpoints de API manualmente en páginas MDX individuales. Este enfoque es útil para APIs pequeñas o para crear prototipos.

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

<Steps>
<Step title="Configura la API">
En tu archivo `docs.json`, define la URL base y el método de autenticación.
<Step title="Configura la configuración de la API">
En tu archivo `docs.json`, configura tu URL base y el método de autenticación.

```json
"api": {
Expand All @@ -26,7 +26,7 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
}
```

Si quieres ocultar el playground de la API, establece el campo `display` en `none`. No necesitas incluir un método de autenticación si ocultas el playground.
Si quieres ocultar el área de pruebas de la API, configura el campo `display` como `none`. No necesitas incluir ningún método de autenticación si ocultas el área de pruebas de la API.

```json
"api": {
Expand All @@ -39,45 +39,45 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
Consulta la lista completa de configuraciones de la API en [Settings](/es/organize/settings#api-configurations).
</Step>

<Step title="Crea las páginas de endpoints">
Crea un archivo `MDX` para cada endpoint. Define `title` y `api` en el frontmatter:
<Step title="Crea las páginas de tus endpoints">
Crea un archivo MDX para cada endpoint. Define `title` y `api` en el frontmatter:

```mdx
---
title: 'Create new user'
title: 'Crear nuevo usuario'
api: 'POST https://api.mintlify.com/user'
---
```

Especifica los parámetros de ruta envolviéndolos entre `{}`:
Especifica los parámetros de ruta colocándolos entre `{}`:

```bash
https://api.example.com/v1/endpoint/{userId}
```

<Tip>
Si tienes un campo `server` configurado en `docs.json`, puedes usar rutas relativas como `/v1/endpoint`.
Si tienes configurado un campo `server` en `docs.json`, puedes usar rutas relativas como `/v1/endpoint`.
</Tip>

Para anular el modo de visualización global del playground en una página específica, agrega `playground` al frontmatter:
Para anular el modo de visualización global del playground en una página específica, añade `playground` al frontmatter:

```mdx
---
title: 'Create new user'
title: 'Crear nuevo usuario'
api: 'POST https://api.mintlify.com/user'
playground: 'none'
---
```

Opciones:
Options:
Copy link

@cursor cursor bot Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Untranslated text in Spanish file

The word "Options:" on line 72 is in English instead of Spanish. This breaks the user experience for Spanish-speaking users. The text should be "Opciones:" to match the Spanish translation pattern used in the French version ("Options :") and maintain consistency with the rest of the Spanish documentation.

Fix in Cursor Fix in Web


* `playground: 'interactive'` - Muestra el playground interactivo (predeterminado)
* `playground: 'simple'` - Muestra un endpoint copiable sin playground
* `playground: 'none'` - Oculta el playground por completo
* `playground: 'interactive'` - Mostrar el playground interactivo (predeterminado)
* `playground: 'simple'` - Mostrar un endpoint copiable sin playground
* `playground: 'none'` - Ocultar el playground por completo
</Step>

<Step title="Agrega parámetros y respuestas">
Usa los [campos de parámetros y respuestas](/es/components/fields) para documentar los parámetros y valores de retorno de tu endpoint.
<Step title="Añadir parámetros y respuestas">
Utiliza los [campos de parámetros y de respuesta](/es/components/fields) para documentar los parámetros y los valores de retorno de tu endpoint.

```mdx
<ParamField path="userId" type="string" required>
Expand All @@ -98,8 +98,76 @@ Puedes definir endpoints de API manualmente en páginas individuales. Este enfoq
```
</Step>

<Step title="Agrega los endpoints a tu documentación">
Agrega las páginas de endpoints a la navegación actualizando el campo `pages` en tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/organize/navigation).
<Step title="Incorpora tus endpoints a tu documentación">
Agrega las páginas de tus endpoints a la navegación actualizando el campo `pages` en tu `docs.json`:

```json docs.json
"navigation": {
"tabs": [
{
"tab": "Referencia de la API",
"groups": [
{
"group": "Usuarios",
"pages": [
"api-reference/users/create-user",
"api-reference/users/get-user",
"api-reference/users/update-user"
]
},
{
"group": "Pedidos",
"pages": [
"api-reference/orders/create-order",
"api-reference/orders/list-orders"
]
}
]
}
]
}
```

Cada ruta de página corresponde a un archivo MDX en tu repositorio de documentación. Por ejemplo, `api-reference/users/create-user.mdx`. Consulta más detalles sobre cómo estructurar tu documentación en [Navigation](/es/organize/navigation).

### Usar endpoints de OpenAPI en navigation

Si tienes una especificación de OpenAPI, puedes hacer referencia a endpoints directamente en tu navigation sin crear archivos MDX individuales. Haz referencia a endpoints específicos incluyendo la ruta del archivo de OpenAPI y el endpoint:

```json docs.json
"navigation": {
"pages": [
"introducción",
"/path/to/users-openapi.json POST /users",
"/path/to/orders-openapi.json GET /orders"
]
}
```

También puedes definir una especificación de OpenAPI predeterminada para un grupo de navigation y hacer referencia a los endpoints por método y ruta:

```json docs.json
{
"group": "Referencia de API",
"openapi": "/path/to/openapi-v1.json",
"pages": [
"descripción-general",
"autenticación",
"GET /users",
"POST /users",
{
"group": "Pedidos",
"openapi": "/path/to/openapi-v2.json",
"pages": [
"GET /orders",
"POST /orders"
]
}
]
}
```

Para más información sobre la integración de OpenAPI, consulta [configuración de OpenAPI](/es/api-playground/openapi-setup).
</Step>
</Steps>

Expand Down
8 changes: 4 additions & 4 deletions es/api-playground/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -149,17 +149,17 @@ Este ejemplo configura el área de pruebas de la API para que sea interactiva, c
### Páginas de endpoints personalizadas
</div>

Cuando necesites más control sobre la documentación de tu API, usa la extensión `x-mint` en tu especificación de OpenAPI o crea páginas `MDX` individuales para tus endpoints.
Cuando necesites más control sobre la documentación de tu API, usa la extensión `x-mint` en tu especificación OpenAPI o crea páginas MDX individuales para tus endpoints.

Ambas opciones te permiten:

* Personalizar los metadatos de la página
* Personalizar el metadata de la página
* Agregar contenido adicional, como ejemplos
* Controlar el comportamiento del playground por página

Se recomienda la extensión `x-mint` para que toda la documentación de tu API se genere automáticamente a partir de tu especificación de OpenAPI y se mantenga en un solo archivo.
Se recomienda la extensión `x-mint` para que toda la documentación de tu API se genere automáticamente a partir de tu especificación OpenAPI y se mantenga en un solo archivo.

Se recomiendan las páginas `MDX` individuales para APIs pequeñas o cuando quieras probar cambios por página.
Las páginas MDX individuales se recomiendan para APIs pequeñas o cuando quieras experimentar con cambios página por página.

<div id="further-reading">
## Lecturas adicionales
Expand Down
2 changes: 1 addition & 1 deletion es/customize/custom-scripts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Los valores arbitrarios de Tailwind CSS no están admitidos. Para valores person
## CSS personalizado
</div>

Agrega archivos CSS a tu repositorio y los nombres de clase definidos se aplicarán y estarán disponibles en todos tus archivos `MDX`.
Añade archivos CSS a tu repositorio y los nombres de clase que definas en ellos se aplicarán y estarán disponibles en todos tus archivos MDX.

<div id="adding-stylecss">
### Agregar `style.css`
Expand Down
17 changes: 7 additions & 10 deletions es/customize/react-components.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,11 @@ import { ColorGenerator } from "/snippets/color-generator.jsx";

Los [componentes de React](https://react.dev) son una forma eficaz de crear elementos interactivos y reutilizables en tu documentación.


<div id="using-react-components">
## Uso de componentes de React
</div>

Puedes construir componentes de React directamente en tus archivos `MDX` con [React hooks](https://react.dev/reference/react/hooks).
Puedes crear componentes de React directamente en tus archivos MDX mediante [hooks de React](https://react.dev/reference/react/hooks).

<div id="example">
### Ejemplo
Expand Down Expand Up @@ -99,15 +98,13 @@ El contador se representa como un componente interactivo de React.
## Importar componentes
</div>

Para importar componentes de React en tus archivos `MDX`, los archivos de los componentes deben estar en la carpeta `snippets`. Luego puedes importarlos en cualquier página `MDX` de tu documentación. Más información en [fragmentos reutilizables](/es/create/reusable-snippets).
Para importar componentes de React en tus archivos MDX, los archivos de los componentes deben estar ubicados en la carpeta `snippets`. Luego puedes importarlos en cualquier página MDX de tu documentación. Más información sobre [snippets reutilizables](/es/create/reusable-snippets).

<div id="example">
### Ejemplo
</div>
### Ejemplo

Este ejemplo declara un componente `ColorGenerator` que utiliza varios hooks de React y luego lo emplea en un archivo `MDX`.
Este ejemplo declara un componente `ColorGenerator` que usa varios hooks de React y luego lo utiliza en un archivo MDX.

Crea el archivo `color-generator.jsx` en la carpeta `snippets`:
Crea un archivo llamado `color-generator.jsx` en la carpeta `snippets`:

```mdx /snippets/color-generator.jsx [expandable]
export const ColorGenerator = () => {
Expand Down Expand Up @@ -222,15 +219,15 @@ export const ColorGenerator = () => {
}
```

Importa el componente `ColorGenerator` y úsalo en un archivo `MDX`:
Importa el componente `ColorGenerator` y úsalo en un archivo MDX:

```mdx
import { ColorGenerator } from "/snippets/color-generator.jsx"

<ColorGenerator />
```

El generador de colores se renderiza como un componente interactivo de React.
El generador de colores se renderiza como un componente de React interactivo.

<ColorGenerator />

Expand Down
24 changes: 12 additions & 12 deletions es/deploy/personalization-setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,10 +49,10 @@ groups: ["admin"]


<div id="user-data-format">
## Formato de datos del usuario
## Formato de datos de usuario
</div>

Al implementar la personalización, tu sistema devuelve los datos del usuario en un formato específico que permite la personalización del contenido. Estos datos pueden enviarse como un objeto JSON sin procesar o dentro de un JWT (JSON Web Token) firmado, según el método de autenticación que utilices. La estructura de los datos es la misma en ambos casos.
Al implementar la personalización, tu sistema devuelve los datos de usuario en un formato específico que permite la personalización del contenido. Estos datos se pueden enviar como un objeto JSON bruto o dentro de un JWT firmado, según tu método de handshake. La estructura de los datos es la misma en ambos casos.

```tsx
type User = {
Expand All @@ -69,8 +69,8 @@ type User = {
```

<ParamField path="expiresAt" type="number">
Tiempo de expiración de la sesión en **segundos desde el epoch**. Si el usuario carga una página después de este momento, sus datos almacenados se eliminan automáticamente y debe volver a autenticarse.
<Warning><b>Para intercambios con JWT:</b> Esto difiere del atributo `exp` del JWT, que determina cuándo se considera inválido un JWT. Por seguridad, establece el `exp` del JWT en una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas).</Warning>
Tiempo de expiración de la sesión en **segundos desde la época Unix**. Si el usuario carga una página después de este tiempo, sus datos almacenados se eliminan automáticamente y debe volver a autenticarse.
<Warning><b>Para intercambios con JWT:</b> Esto es distinto del claim `exp` del JWT, que determina cuándo un JWT se considera inválido. Por seguridad, configura el claim `exp` del JWT con una duración corta (10 segundos o menos). Usa `expiresAt` para la duración real de la sesión (de horas a semanas).</Warning>
</ParamField>

<ParamField path="groups" type="string[]">
Expand All @@ -80,26 +80,26 @@ type User = {
</ParamField>

<ParamField path="content" type="object">
Datos personalizados accesibles en tu contenido `MDX` mediante la variable `user`. Úsalos para personalizar dinámicamente tu documentación.
Datos personalizados accesibles en tu contenido MDX a través de la variable `user`. Úsalos para realizar personalización dinámica en toda tu documentación.

**Ejemplo básico**:

```json
{ "firstName": "Ronan", "company": "Acme Corp", "plan": "Enterprise" }
```

**Uso en `MDX`**:
**Uso en MDX**:

```mdx
Welcome back, {user.firstName}! Your {user.plan} plan includes...
```

Con los datos de `user` del ejemplo, se mostraría como: Welcome back, Ronan! Your Enterprise plan includes...
Con el ejemplo de datos de `user`, esto se renderizaría como: Welcome back, Ronan! Your Enterprise plan includes...

**Renderizado condicional avanzado**:

```jsx
La autenticación es una función de Enterprise. {
Authentication is an enterprise feature. {
user.org === undefined
? <>To access this feature, first create an account at the <a href="https://dashboard.mintlify.com/login">Mintlify dashboard</a>.</>
: user.org.plan !== 'enterprise'
Expand All @@ -109,12 +109,12 @@ type User = {
```

<Note>
La información en `user` solo está disponible para usuarios con sesión iniciada. Para los usuarios que no han iniciado sesión, el valor de `user` será `{}`. Para evitar que la página falle con usuarios desconectados, usa siempre el encadenamiento opcional en los campos de `user`. Por ejemplo, `{user.org?.plan}`.
La información en `user` solo está disponible para usuarios con sesión iniciada. Para usuarios sin iniciar sesión, el valor de `user` será `{}`. Para evitar que la página falle para usuarios sin iniciar sesión, usa siempre encadenamiento opcional en los campos de `user`. Por ejemplo, `{user.org?.plan}`.
</Note>
</ParamField>

<ParamField path="apiPlaygroundInputs" type="object">
Valores específicos del usuario que rellenan por adelantado los campos del área de pruebas de la API. Ahorra tiempo a los usuarios al autocompletar sus datos cuando prueban APIs.
Valores específicos del usuario que rellenan previamente los campos del área de pruebas de la API. Ahorra tiempo a los usuarios al autocompletar sus datos cuando prueban APIs.

**Ejemplo**:

Expand All @@ -126,9 +126,9 @@ type User = {
}
```

Si un usuario realiza solicitudes en un subdomain específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se rellenará por adelantado en cualquier página de la API con el valor `subdomain`.
Si un usuario realiza solicitudes en un subdominio específico, puedes enviar `{ server: { subdomain: 'foo' } }` como un campo `apiPlaygroundInputs`. Este valor se rellenará previamente en cualquier página de la API con el valor `subdomain`.

<Note>Los campos `header`, `query` y `cookie` solo se rellenarán por adelantado si forman parte de tu [esquema de seguridad de OpenAPI](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se rellenará por adelantado. Crear un parámetro de encabezado estándar llamado `Authorization` no habilitará esta función.</Note>
<Note>Los campos `header`, `query` y `cookie` solo se rellenarán previamente si forman parte de tu [esquema de seguridad de OpenAPI](https://swagger.io/docs/specification/authentication/). Si un campo está en las secciones `Authorization` o `Server`, se rellenará previamente. Crear un parámetro de encabezado estándar llamado `Authorization` no habilitará esta función.</Note>
</ParamField>


Expand Down
18 changes: 9 additions & 9 deletions es/editor.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,15 +72,15 @@ El modo visual ofrece una experiencia WYSIWYG (what you see is what you get) en
</Frame>

<div id="markdown-mode">
### Modo Markdown
### Markdown mode
Copy link

@cursor cursor bot Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Untranslated heading in Spanish file

The heading "Markdown mode" on line 75 is in English instead of Spanish. This is inconsistent with the rest of the Spanish translation and breaks the user experience for Spanish-speaking users. The heading should be translated to "Modo Markdown" to match the pattern used in the French version and maintain consistency with the rest of the Spanish documentation.

Fix in Cursor Fix in Web

</div>

Modo Markdown proporciona acceso directo al código `MDX` subyacente de tu documentación. Este modo es ideal cuando necesitas un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de Markdown.
Markdown mode ofrece acceso directo a los archivos que conforman tu documentación. Este modo es ideal cuando necesitas tener un control preciso sobre las propiedades de los componentes o cuando prefieres escribir con la sintaxis de MDX.

<Frame>
<img src="/images/editor/markdown-mode-light.png" alt="Modo Markdown en el editor visual de Mintlify" className="block dark:hidden" />
<img src="/images/editor/markdown-mode-light.png" alt="Markdown mode en el editor visual de Mintlify" className="block dark:hidden" />

<img src="/images/editor/markdown-mode-dark.png" alt="Modo Markdown en el editor visual de Mintlify" className="hidden dark:block" />
<img src="/images/editor/markdown-mode-dark.png" alt="Markdown mode en el editor visual de Mintlify" className="hidden dark:block" />
</Frame>

<div id="manage-content">
Expand Down Expand Up @@ -179,23 +179,23 @@ En este ejemplo, creaste una nueva página titulada Temas y quieres agregarla al
### Editar contenido
</div>

Realiza cambios en tus páginas usando el modo visual o el Modo Markdown en el editor.
Realiza cambios en tus páginas usando el modo visual o Markdown mode en el editor.

En el modo visual, presiona <kbd>/</kbd> para abrir el menú de componentes. Agrega bloques de contenido, avisos, bloques de código y otros componentes para personalizar tu documentación.
En el modo visual, presiona <kbd>/</kbd> para abrir el menú de componentes. Agrega bloques de contenido, notas, bloques de código y otros componentes para personalizar tu documentación.

<Frame>
<img src="/images/editor/component-menu-light.png" alt="El menú de componentes desplegado resaltado en el editor visual de Mintlify" className="block dark:hidden" />

<img src="/images/editor/component-menu-dark.png" alt="El menú de componentes desplegado resaltado en el editor visual de Mintlify" className="hidden dark:block" />
</Frame>

En el Modo Markdown, editas directamente el `MDX` de tus páginas. Esto puede ser útil cuando necesitas:
En Markdown mode, puedes editar directamente el MDX de tus páginas. Esto puede ser útil cuando necesitas:

* Definir propiedades específicas de los componentes
* Trabajar con componentes anidados complejos
* Copiar y pegar contenido `MDX` de otras fuentes
* Copiar y pegar contenido MDX desde otras fuentes

Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir con la sintaxis de Markdown.
Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir usando la sintaxis de MDX.

<div id="publish-your-changes">
## Publica tus cambios
Expand Down
Loading