Skip to content

feat(locadex): continuous i18n #1469

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 6, 2025
+140 −71
Merged

feat(locadex): continuous i18n #1469

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
9 changes: 6 additions & 3 deletions es/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -307,14 +307,15 @@ En el objeto `navigation`, `dropdowns` es un array donde cada entrada es un obje

Los productos crean una sección de navegación dedicada para organizar la documentación específica de cada producto. Usa productos para separar distintas ofertas, servicios o conjuntos de funciones principales dentro de tu documentación.

En el objeto `navigation`, `products` es un arreglo en el que cada entrada es un objeto que requiere un campo `product` y puede contener otros campos de navegación como groups, pages, icon o enlaces a páginas externas.
En el objeto `navigation`, `products` es un arreglo donde cada entrada es un objeto que requiere un campo `product` y puede contener otros campos de navegación como groups, pages, icons o enlaces a páginas externas.

```json
{
"navigation": {
"products": [
{
"product": "API Principal",
"product": "Core API",
"description": "Descripción de la API principal",
"icon": "api",
"groups": [
{
Expand All @@ -335,6 +336,7 @@ En el objeto `navigation`, `products` es un arreglo en el que cada entrada es un
},
{
"product": "Plataforma de Analytics",
"description": "Descripción de la Plataforma de Analytics",
"icon": "chart-bar",
"pages": [
"analytics/overview",
Expand All @@ -343,7 +345,8 @@ En el objeto `navigation`, `products` es un arreglo en el que cada entrada es un
]
},
{
"product": "SDK Móvil",
"product": "SDK móvil",
"description": "Descripción del SDK móvil",
"icon": "smartphone",
"href": "https://mobile-sdk-docs.example.com"
}
Expand Down
58 changes: 39 additions & 19 deletions es/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -380,29 +380,29 @@ Esta sección contiene la referencia completa del archivo `docs.json`.

<Expandable title="Global">
<ResponseField name="idiomas" type="array of object">
Configuración del selector de idioma para sitios con localización.
Configuración del selector de idioma para sitios localizados.

<Expandable title="Languages">
<ResponseField name="language" type="&#x22;en&#x22; | &#x22;cn&#x22; | &#x22;zh&#x22; | &#x22;zh-Hans&#x22; | &#x22;zh-Hant&#x22; | &#x22;es&#x22; | &#x22;fr&#x22; | &#x22;ja&#x22; | &#x22;jp&#x22; | &#x22;pt&#x22; | &#x22;pt-BR&#x22; | &#x22;de&#x22; | &#x22;ko&#x22; | &#x22;it&#x22; | &#x22;ru&#x22; | &#x22;id&#x22; | &#x22;ar&#x22; | &#x22;tr&#x22;" required>
Código de idioma en formato ISO 639-1.
Código de idioma en formato ISO 639-1
</ResponseField>

<ResponseField name="default" type="boolean">
Indica si este es el idioma predeterminado.
Indica si es el idioma predeterminado.
</ResponseField>

<ResponseField name="hidden" type="boolean">
Indica si se debe ocultar esta opción de idioma de forma predeterminada.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
Ruta válida o enlace externo a la versión de tu documentación en este idioma.
Una ruta válida o un enlace externo a la versión de tu documentación en este idioma.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="versiones" type="array of object">
Configuración del conmutador de versiones para sitios con varias versiones.
Configuración del selector de versiones para sitios con múltiples versiones.

<Expandable title="Versions">
<ResponseField name="version" type="string" required>
Expand All @@ -416,7 +416,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="hidden" type="boolean">
Indica si se debe ocultar esta opción de versión de forma predeterminada.
Indica si se debe ocultar esta opción de versión por defecto.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
Expand All @@ -426,7 +426,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="pestañas" type="array of object">
Pestañas de navegación de nivel superior para organizar las secciones principales.
Pestañas de navegación de nivel superior para organizar secciones principales.

<Expandable title="Tabs">
<ResponseField name="tab" type="string" required>
Expand All @@ -442,17 +442,17 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
URL o ruta de destino de la Tab.
URL o ruta al destino de la Tab.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="anclas" type="array of object">
Enlaces con ancla que aparecen de forma destacada en la navigation de la barra lateral.
<ResponseField name="anclajes" type="array of object">
Enlaces ancla que aparecen de forma destacada en la navigation de la barra lateral.

<Expandable title="Anclas">
<Expandable title="Anchors">
<ResponseField name="anchor" type="string" required>
Nombre visible del ancla.
Nombre para mostrar del ancla.

Longitud mínima: 1
</ResponseField>
Expand Down Expand Up @@ -482,45 +482,61 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
URL o ruta del destino del ancla.
URL o ruta de destino del ancla.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="menús desplegables" type="array of object">
Menús desplegables para organizar contenido relacionado.

<Expandable title="Desplegables">
<Expandable title="Menús desplegables">
<ResponseField name="dropdown" type="string" required>
Nombre visible del desplegable.
Nombre visible del menú desplegable.

Longitud mínima: 1
</ResponseField>

<IconsOptional />

<ResponseField name="hidden" type="boolean">
Indica si este desplegable se oculta de forma predeterminada.
Indica si este menú desplegable se oculta de forma predeterminada.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
URL o ruta de destino del desplegable.
URL o ruta de destino del menú desplegable.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="productos" type="array of object">
Productos para organizar el contenido en secciones.

<Expandable title="Products">
<ResponseField name="product" type="string" required>
Nombre visible del producto.
</ResponseField>

<ResponseField name="description" type="string">
Descripción del producto.
</ResponseField>

<IconsOptional />
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="idiomas" type="array of object">
Selector de idioma para sitios [multilingües](es/navigation#languages).
Selector de idiomas para sitios [multilingües](es/navigation#languages).
</ResponseField>

<ResponseField name="versiones" type="array of object">
Selector de versión para sitios con varias [versiones](es/navigation#versions).
</ResponseField>

<ResponseField name="pestañas" type="array of object">
Pestañas de navigation de nivel superior [Tabs](es/navigation#tabs).
Pestañas de navegación de nivel superior [tabs](es/navigation#tabs).
</ResponseField>

<ResponseField name="anclas" type="array of object">
Expand All @@ -531,6 +547,10 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
[Menús desplegables](es/navigation#dropdowns) para agrupar contenido relacionado.
</ResponseField>

<ResponseField name="productos" type="array of object">
Selector de producto para sitios con varios [productos](es/navigation#products).
</ResponseField>

<ResponseField name="groups" type="array of object">
[Groups](es/navigation#groups) para organizar el contenido en secciones.
</ResponseField>
Expand Down
17 changes: 10 additions & 7 deletions fr/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -301,20 +301,21 @@ Dans l’objet `navigation`, `dropdowns` est un tableau où chaque entrée est u
## Produits
</div>

<img className="block dark:hidden pointer-events-none" src="/images/navigation/product-switcher-light.png" alt="Graphique décoratif d’un sélecteur de produit." />
<img className="block dark:hidden pointer-events-none" src="/images/navigation/product-switcher-light.png" alt="Illustration décorative d’un sélecteur de produit." />

<img className="hidden dark:block pointer-events-none" src="/images/navigation/product-switcher-dark.png" alt="Graphique décoratif d’un sélecteur de produit." />
<img className="hidden dark:block pointer-events-none" src="/images/navigation/product-switcher-dark.png" alt="Illustration décorative d’un sélecteur de produit." />

Les produits créent une section dédiée dans la navigation pour organiser la documentation propre à chaque produit. Utilisez les produits pour séparer différentes offres, services ou ensembles de fonctionnalités majeures au sein de votre documentation.
Les produits créent une section de navigation dédiée pour organiser la documentation propre à chaque produit. Utilisez les produits pour séparer différentes offres, services ou grands ensembles de fonctionnalités au sein de votre documentation.

Dans l’objet `navigation`, `products` est un tableau où chaque élément est un objet qui exige un champ `product` et peut contenir d’autres champs de navigation tels que groups, pages, icon, ou des liens vers des pages externes.
Dans l’objet `navigation`, `products` est un tableau où chaque entrée est un objet qui exige un champ `product` et peut contenir d’autres champs de navigation tels que des groupes, des pages, des icons ou des liens vers des pages externes.

```json
{
"navigation": {
"products": [
{
"product": "API Core",
"product": "Core API",
"description": "Description de l'API Core",
"icon": "api",
"groups": [
{
Expand All @@ -334,7 +335,8 @@ Dans l’objet `navigation`, `products` est un tableau où chaque élément est
]
},
{
"product": "Plateforme Analytics",
"product": "Analytics Platform",
"description": "Description de la plateforme Analytics",
"icon": "chart-bar",
"pages": [
"analytics/overview",
Expand All @@ -343,7 +345,8 @@ Dans l’objet `navigation`, `products` est un tableau où chaque élément est
]
},
{
"SDK Mobile",
"product": "Mobile SDK",
"description": "Description du SDK Mobile",
"icon": "smartphone",
"href": "https://mobile-sdk-docs.example.com"
}
Expand Down
58 changes: 39 additions & 19 deletions fr/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -384,29 +384,29 @@ Cette section présente la référence complète du fichier `docs.json`.

<Expandable title="Langues">
<ResponseField name="language" type="&#x22;en&#x22; | &#x22;cn&#x22; | &#x22;zh&#x22; | &#x22;zh-Hans&#x22; | &#x22;zh-Hant&#x22; | &#x22;es&#x22; | &#x22;fr&#x22; | &#x22;ja&#x22; | &#x22;jp&#x22; | &#x22;pt&#x22; | &#x22;pt-BR&#x22; | &#x22;de&#x22; | &#x22;ko&#x22; | &#x22;it&#x22; | &#x22;ru&#x22; | &#x22;id&#x22; | &#x22;ar&#x22; | &#x22;tr&#x22;" required>
Code de langue au format ISO 639-1
Code de langue au format ISO 639-1.
</ResponseField>

<ResponseField name="default" type="boolean">
Indique s’il s’agit de la langue par défaut.
</ResponseField>

<ResponseField name="hidden" type="boolean">
Indique s’il faut masquer cette option de langue par défaut.
Indique s’il faut masquer cette langue par défaut.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
Un chemin ou un lien externe valide vers la version correspondante de votre documentation.
Un chemin valide ou un lien externe vers cette version de votre documentation.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="versions" type="array of object">
Configuration du sélecteur de version pour les sites multiversions.
Configuration du sélecteur de versions pour les sites multiversions.

<Expandable title="Versions">
<ResponseField name="version" type="string" required>
Nom d’affichage de la version.
Nom affiché de la version.

Longueur minimale : 1
</ResponseField>
Expand All @@ -416,7 +416,7 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="hidden" type="boolean">
Indique si cette option de version doit être masquée par défaut.
Indique s’il faut masquer cette option de version par défaut.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
Expand All @@ -430,7 +430,7 @@ Cette section présente la référence complète du fichier `docs.json`.

<Expandable title="Tabs">
<ResponseField name="tab" type="string" required>
Nom affiché de l’onglet.
Nom d’affichage de l’onglet.

Longueur minimale : 1
</ResponseField>
Expand All @@ -442,17 +442,17 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
URL ou chemin vers la destination de l’onglet.
URL ou chemin de destination de l’onglet.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="ancres" type="array of object">
Liens d’ancrage affichés en évidence dans la navigation de la barre latérale.
Liens d’ancrage mis en avant dans la navigation de la barre latérale.

<Expandable title="Anchors">
<Expandable title="Ancres">
<ResponseField name="anchor" type="string" required>
Nom d’affichage de l’ancre.
Nom affiché de l’ancre.

Longueur minimale : 1
</ResponseField>
Expand All @@ -462,7 +462,7 @@ Cette section présente la référence complète du fichier `docs.json`.
<ResponseField name="color" type="object">
Couleurs personnalisées de l’ancre.

<Expandable title="Color">
<Expandable title="Couleur">
<ResponseField name="light" type="string matching ^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$">
Couleur de l’ancre en mode clair.

Expand All @@ -478,7 +478,7 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="hidden" type="boolean">
Indique si cette ancre doit être masquée par défaut.
Indique s’il faut masquer cette ancre par défaut.
</ResponseField>

<ResponseField name="href" type="string (uri)" required>
Expand All @@ -487,10 +487,10 @@ Cette section présente la référence complète du fichier `docs.json`.
</Expandable>
</ResponseField>

<ResponseField name="menus déroulants" type="array of object">
<ResponseField name="listes déroulantes" type="array of object">
Menus déroulants pour organiser du contenu connexe.

<Expandable title="Dropdowns">
<Expandable title="Menus déroulants">
<ResponseField name="dropdown" type="string" required>
Nom d’affichage du menu déroulant.

Expand All @@ -508,6 +508,22 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="produits" type="array of object">
Produits pour organiser le contenu en sections.

<Expandable title="Produits">
<ResponseField name="product" type="string" required>
Nom d’affichage du produit.
</ResponseField>

<ResponseField name="description" type="string">
Description du produit.
</ResponseField>

<IconsOptional />
</Expandable>
</ResponseField>
</Expandable>
</ResponseField>

Expand All @@ -520,23 +536,27 @@ Cette section présente la référence complète du fichier `docs.json`.
</ResponseField>

<ResponseField name="Onglets" type="array of object">
Onglets de navigation de niveau supérieur [Onglets](fr/navigation#tabs).
Onglets de navigation de premier niveau [tabs](fr/navigation#tabs).
</ResponseField>

<ResponseField name="ancres" type="array of object">
Ancres dans la barre latérale : [anchors](fr/navigation#anchors).
Barre latérale : [ancres](fr/navigation#anchors).
</ResponseField>

<ResponseField name="menus déroulants" type="array of object">
[Menus déroulants](fr/navigation#dropdowns) pour regrouper du contenu lié.
[Listes déroulantes](fr/navigation#dropdowns) pour regrouper du contenu lié.
</ResponseField>

<ResponseField name="produits" type="array of object">
Sélecteur de produit pour les sites proposant plusieurs [products](fr/navigation#products).
</ResponseField>

<ResponseField name="groups" type="array of object">
[Groupes](fr/navigation#groups) pour organiser le contenu en sections.
</ResponseField>

<ResponseField name="pages" type="array of string or object">
Des [pages](fr/navigation#pages) individuelles qui constituent votre documentation.
Des [pages](fr/navigation#pages) individuelles qui composent votre documentation.
</ResponseField>
</Expandable>
</ResponseField>
Expand Down
Loading