Skip to content

feat(locadex): continuous i18n #1976

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
ethanpalm merged 1 commit into from
Dec 1, 2025
+545 −496
Merged

feat(locadex): continuous i18n #1976

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
20 changes: 13 additions & 7 deletions es/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -365,20 +365,28 @@ En el objeto `navigation`, `products` es un arreglo donde cada entrada es un obj
## OpenAPI
</div>

Integra especificaciones de OpenAPI directamente en tu estructura de navegación para generar automáticamente la documentación de tu API. Crea secciones de API dedicadas o coloca páginas de endpoints dentro de otros componentes de la navegación.
Integra especificaciones de OpenAPI directamente en la estructura de navegación para generar automáticamente la documentación de tu API. Crea secciones de API dedicadas o coloca páginas de endpoints dentro de otros componentes de navegación.

Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu jerarquía de navegación. Los elementos descendientes heredarán esta especificación a menos que definan la suya propia.
Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu jerarquía de navegación. Los elementos secundarios heredarán esta especificación a menos que definan la suya propia.

<Note>
Cuando agregas la propiedad `openapi` a un elemento de navegación (como un anchor, tab o group) sin especificar ninguna página, Mintlify genera automáticamente páginas para **todos los endpoints** definidos en tu especificación de OpenAPI.

Para controlar qué endpoints aparecen, enumera explícitamente los endpoints deseados en un arreglo `pages`.
</Note>

Para obtener más información sobre cómo hacer referencia a endpoints de OpenAPI en tu documentación, consulta la sección [Configuración de OpenAPI](/es/api-playground/openapi-setup).

```json
{
"navigation": {
"groups": [
{
"group": "Referencia de API",
"group": "Referencia de la API",
"openapi": "/path/to/openapi-v1.json",
"pages": [
"overview",
"authentication",
"descripción-general",
"autenticación",
"GET /users",
"POST /users",
{
Expand All @@ -396,8 +404,6 @@ Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu
}
```

Para obtener más información sobre cómo hacer referencia a endpoints de OpenAPI en tu documentación, consulta la [configuración de OpenAPI](/es/api-playground/openapi-setup).

<div id="versions">
## Versiones
</div>
Expand Down
37 changes: 20 additions & 17 deletions es/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,32 +140,35 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="styling" type="object">
Configuraciones de estilo visual.
Configuración de estilo visual.

<Expandable title="Styling">
<Expandable title="Estilo">
<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 de navegación completa. El valor predeterminado es `section`.
El estilo del eyebrow (encabezado superior) de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta de navegación completa. El valor predeterminado es `section`.
</ResponseField>

<ResponseField name="latex" type="boolean">
Controla si se incluyen las hojas de estilo de LaTeX, anulando la detección automática.
Controla si se incluyen las hojas de estilo de LaTeX, anulando la detección automática. De forma predeterminada, Mintlify detecta automáticamente el uso de LaTeX en tu contenido y carga las hojas de estilo necesarias.

* Establécelo en `true` para forzar la carga de las hojas de estilo de LaTeX cuando la detección automática no reconozca tus expresiones matemáticas.
* Establécelo en `false` para evitar cargar las hojas de estilo de LaTeX y mejorar el rendimiento si no usas expresiones matemáticas pero tienes contenido que activa una detección de falso positivo.
</ResponseField>

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

**Configuración simple:**

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

**Configuración de tema personalizada:**
**Configuración de tema personalizado:**

* 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 system
* Usa un objeto para especificar [temas de Shiki](https://shiki.style/themes) separados para los modos claro y oscuro

<ResponseField name="theme" type="string">
Un único nombre de tema de Shiki para usar en los modos claro y system.
Un único nombre de tema de Shiki que se usará tanto para los modos claro como oscuro.

```json
"styling": {
Expand All @@ -177,23 +180,23 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="theme" type="object">
Temas separados para los modos claro y system.
Temas separados para los modos claro y oscuro.

<Expandable title="theme">
<ResponseField name="light" type="string" required>
Un nombre de tema de Shiki para el modo claro.
</ResponseField>

<ResponseField name="dark" type="string" required>
Un nombre de tema de Shiki para el modo system.
Un nombre de tema de Shiki para el modo oscuro.
</ResponseField>

```json
"styling": {
"codeblocks": {
"theme": {
"light": "github-light",
"dark": "github-system"
"dark": "github-dark"
}
}
}
Expand All @@ -205,14 +208,14 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="icons" type="object">
Configuración de la biblioteca de íconos.
Configuración de la biblioteca de iconos.

<Expandable title="Icons">
<Expandable title="Iconos">
<ResponseField name="library" type="&#x22;fontawesome&#x22; | &#x22;lucide&#x22;" required>
Biblioteca de íconos que se usará en toda tu documentación. El valor predeterminado es `fontawesome`.
Biblioteca de iconos que se usará en toda tu documentación. El valor predeterminado es `fontawesome`.

<Note>
Puedes especificar una URL a un ícono alojado externamente, una ruta a un archivo de ícono en tu proyecto o código SVG compatible con JSX para cualquier ícono individual, independientemente de la configuración de la biblioteca.
Puedes especificar una URL de un icono alojado externamente, una 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.
</Note>
</ResponseField>
</Expandable>
Expand Down
20 changes: 13 additions & 7 deletions fr/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -365,20 +365,28 @@ Dans l’objet `navigation`, `products` est un tableau où chaque entrée est un
## OpenAPI
</div>

Intégrez des spécifications OpenAPI directement dans votre structure de navigation pour générer automatiquement la documentation de votre API. Créez des sections API dédiées ou placez des pages d’endpoints au sein d’autres éléments de navigation.
Intégrez des spécifications OpenAPI directement dans votre structure de navigation afin de générer automatiquement la documentation de votre API. Créez des sections d’API dédiées ou placez des pages d’endpoints au sein d’autres composants de navigation.

Définissez une spécification OpenAPI par défaut à n’importe quel niveau de votre hiérarchie de navigation. Les éléments enfants hériteront de cette spécification, sauf s’ils définissent la leur.
Définissez une spécification OpenAPI par défaut à n’importe quel niveau de votre hiérarchie de navigation. Les éléments enfants hériteront de cette spécification, sauf s’ils définissent leur propre spécification.

<Note>
Lorsque vous ajoutez la propriété `openapi` à un élément de navigation (comme une ancre, un onglet ou un groupe) sans spécifier de pages, Mintlify génère automatiquement des pages pour **tous les endpoints** définis dans votre spécification OpenAPI.

Pour contrôler les endpoints qui apparaissent, énumérez explicitement les endpoints souhaités dans un tableau `pages`.
</Note>

Pour plus d’informations sur la manière de référencer des endpoints OpenAPI dans votre documentation, consultez la page [Configuration d’OpenAPI](/fr/api-playground/openapi-setup).

```json
{
"navigation": {
"groups": [
{
"group": "Référence API",
"group": "Référence de l'API",
"openapi": "/path/to/openapi-v1.json",
"pages": [
"overview",
"authentication",
"apercu",
"authentification",
"GET /users",
"POST /users",
{
Expand All @@ -396,8 +404,6 @@ Définissez une spécification OpenAPI par défaut à n’importe quel niveau de
}
```

Pour en savoir plus sur la façon de référencer des endpoints OpenAPI dans votre documentation, consultez la page [OpenAPI setup](/fr/api-playground/openapi-setup).

<div id="versions">
## Versions
</div>
Expand Down
15 changes: 9 additions & 6 deletions fr/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -144,28 +144,31 @@ Cette section présente la référence complète du fichier `docs.json`.

<Expandable title="Style">
<ResponseField name="eyebrows" type="&#x22;section&#x22; | &#x22;breadcrumbs&#x22;">
Style de l’« eyebrow » de la page. Choisissez `section` pour afficher le nom de la section ou `breadcrumbs` pour afficher le chemin de navigation complet. La valeur par défaut est `section`.
Le style de l’eyebrow de la page. Choisissez `section` pour afficher le nom de la section ou `breadcrumbs` pour afficher le chemin de navigation complet. Par défaut, la valeur est `section`.
</ResponseField>

<ResponseField name="latex" type="boolean">
Indique si les feuilles de style LaTeX sont incluses, en remplaçant la détection automatique.
Contrôle si les feuilles de style LaTeX sont incluses, en remplaçant la détection automatique. Par défaut, Mintlify détecte automatiquement l’utilisation de LaTeX dans votre contenu et charge les feuilles de style nécessaires.

* Définissez sur `true` pour forcer le chargement des feuilles de style LaTeX lorsque la détection automatique ne reconnaît pas vos expressions mathématiques.
* Définissez sur `false` pour empêcher le chargement des feuilles de style LaTeX afin d’améliorer les performances si vous n’utilisez pas d’expressions mathématiques mais avez du contenu qui déclenche une détection faussement positive.
</ResponseField>

<ResponseField name="codeblocks" type="&#x22;system&#x22; | &#x22;dark&#x22; | string | object">
Configuration du thème des blocs de code. La valeur par défaut est `"system"`.

**Configuration simple :**

* `"system"` : correspond au mode actuel du site (clair ou sombre)
* `"dark"` : utilise toujours le mode sombre
* `"system"` : Adapter le mode actuel du site (clair ou sombre)
* `"dark"` : Toujours utiliser le mode sombre

**Configuration de thème personnalisée :**

* Utilisez une chaîne pour spécifier un seul [thème Shiki](https://shiki.style/themes) pour tous les blocs de code
* Utilisez une chaîne de caractères pour spécifier un seul [thème Shiki](https://shiki.style/themes) pour tous les blocs de code
* Utilisez un objet pour spécifier des [thèmes Shiki](https://shiki.style/themes) distincts pour les modes clair et sombre

<ResponseField name="theme" type="string">
Un seul nom de thème Shiki à utiliser pour les modes clair et sombre.
Un nom de thème Shiki unique à utiliser pour les modes clair et sombre.

```json
"styling": {
Expand Down
Loading