Skip to content

Translate localized footer and navbar documentation to es/fr/zh #4287

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

Closed
mintlify wants to merge 1 commit into from
Closed

Translate localized footer and navbar documentation to es/fr/zh #4287

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
89 changes: 88 additions & 1 deletion es/guides/internationalization.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Crea un directorio separado para cada idioma usando los [códigos de idioma ISO
- `ru` - ruso
- `sv` - sueco
- `tr` - turco
- `ua` - ucraniano
- `uk` - ucraniano
- `uz` - uzbeko
- `vi` - vietnamita
</Expandable>
Expand Down Expand Up @@ -209,6 +209,93 @@ Para añadir elementos de navegación global que aparezcan en todos los idiomas,
```


<div id="localized-footer-and-navbar">
### Pie de página y barra de navegación localizados
</div>

Personaliza el pie de página y la barra de navegación para cada idioma para mostrar contenido traducido y enlaces específicos de cada región.

Añade las propiedades `footer` y `navbar` a cada configuración de idioma:

```json docs.json
{
"navigation": {
"languages": [
{
"language": "en",
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Resources",
"items": [
{ "label": "Documentation", "href": "/en/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Docs", "href": "/en/docs" }
],
"primary": {
"type": "button",
"label": "Get Started",
"href": "/en/quickstart"
}
},
"groups": [
{
"group": "Getting started",
"pages": ["en/quickstart", "en/index"]
}
]
},
{
"language": "es",
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Recursos",
"items": [
{ "label": "Documentación", "href": "/es/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Documentación", "href": "/es/docs" }
],
"primary": {
"type": "button",
"label": "Comenzar",
"href": "/es/quickstart"
}
},
"groups": [
{
"group": "Comenzando",
"pages": ["es/quickstart", "es/index"]
}
]
}
]
}
}
```

Las propiedades `footer` y `navbar` específicas de un idioma sobrescriben la configuración global para ese idioma. Si un idioma no define estas propiedades, heredará la configuración global.

También puedes configurar un `banner` específico por idioma utilizando el mismo patrón.

<div id="maintain-translations">
## Mantén las traducciones
</div>
Expand Down
50 changes: 49 additions & 1 deletion es/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -552,7 +552,7 @@ Divide tu navegación en diferentes idiomas. Los idiomas se pueden seleccionar d
alt="Gráfico decorativo de un selector de idioma."
/>

En el objeto `navigation`, `languages` es un array donde cada entrada es un objeto que requiere un campo `language` y puede contener cualquier otro campo de navegación, incluidas configuraciones de banners específicas por idioma.
En el objeto `navigation`, `languages` es un array donde cada entrada es un objeto que requiere un campo `language` y puede contener cualquier otro campo de navegación, incluidas configuraciones de banner, footer y navbar específicas por idioma.

Actualmente ofrecemos compatibilidad con los siguientes idiomas para la localización:

Expand Down Expand Up @@ -596,6 +596,30 @@ Actualmente ofrecemos compatibilidad con los siguientes idiomas para la localiza
"content": "🚀 Version 2.0 is now live! See our [changelog](/en/changelog) for details.",
"dismissible": true
},
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Resources",
"items": [
{ "label": "Documentation", "href": "/en/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Docs", "href": "/en/docs" }
],
"primary": {
"type": "button",
"label": "Get Started",
"href": "/en/quickstart"
}
},
"groups": [
{
"group": "Getting started",
Expand All @@ -609,6 +633,30 @@ Actualmente ofrecemos compatibilidad con los siguientes idiomas para la localiza
"content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/es/changelog).",
"dismissible": true
},
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Recursos",
"items": [
{ "label": "Documentación", "href": "/es/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Documentación", "href": "/es/docs" }
],
"primary": {
"type": "button",
"label": "Comenzar",
"href": "/es/quickstart"
}
},
"groups": [
{
"group": "Getting started",
Expand Down
23 changes: 22 additions & 1 deletion es/organize/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -597,7 +597,28 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
</ResponseField>

<ResponseField name="languages" type="array of object">
Selector de idioma para sitios [multi-language](/es/organize/navigation#languages).
Selector de idioma para sitios [multi-language](/es/organize/navigation#languages). Cada entrada de idioma puede incluir configuraciones de `banner`, `footer` y `navbar` específicas del idioma, además de la estructura de navegación.

<Expandable title="Languages">
<ResponseField name="language" type='"ar" | "ca" | "cn" | "cs" | "de" | "en" | "es" | "fr" | "he" | "hi" | "id" | "it" | "ja" | "jp" | "ko" | "lv" | "nl" | "no" | "pl" | "pt" | "pt-BR" | "ro" | "ru" | "sv" | "tr" | "uk" | "uz" | "vi" | "zh" | "zh-Hans" | "zh-Hant"' required>
Código de idioma en formato ISO 639-1.
</ResponseField>
<ResponseField name="default" type="boolean">
Si este es el idioma predeterminado.
</ResponseField>
<ResponseField name="banner" type="object">
Configuración de banner específica del idioma. Consulta [banner](#param-banner-1) para ver las opciones disponibles.
</ResponseField>
<ResponseField name="footer" type="object">
Configuración de footer específica del idioma. Consulta [footer](#param-footer-1) para ver las opciones disponibles.
</ResponseField>
<ResponseField name="navbar" type="object">
Configuración de navbar específica del idioma. Consulta [navbar](#param-navbar-1) para ver las opciones disponibles.
</ResponseField>
<ResponseField name="hidden" type="boolean">
Si se debe ocultar esta opción de idioma de forma predeterminada.
</ResponseField>
</Expandable>
</ResponseField>

<ResponseField name="versions" type="array of object">
Expand Down
89 changes: 88 additions & 1 deletion fr/guides/internationalization.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Créez un répertoire séparé pour chaque langue en utilisant les [codes de lan
- `ru` - russe
- `sv` - suédois
- `tr` - turc
- `ua` - ukrainien
- `uk` - ukrainien
- `uz` - ouzbek
- `vi` - vietnamien
</Expandable>
Expand Down Expand Up @@ -209,6 +209,93 @@ Pour ajouter des éléments de navigation globaux qui apparaissent dans toutes l
```


<div id="localized-footer-and-navbar">
### Pied de page et barre de navigation localisés
</div>

Personnalisez le pied de page et la barre de navigation pour chaque langue afin d'afficher du contenu traduit et des liens spécifiques à chaque région.

Ajoutez les propriétés `footer` et `navbar` à chaque configuration de langue :

```json docs.json
{
"navigation": {
"languages": [
{
"language": "en",
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Resources",
"items": [
{ "label": "Documentation", "href": "/en/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Docs", "href": "/en/docs" }
],
"primary": {
"type": "button",
"label": "Get Started",
"href": "/en/quickstart"
}
},
"groups": [
{
"group": "Getting started",
"pages": ["en/quickstart", "en/index"]
}
]
},
{
"language": "es",
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Recursos",
"items": [
{ "label": "Documentación", "href": "/es/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Documentación", "href": "/es/docs" }
],
"primary": {
"type": "button",
"label": "Comenzar",
"href": "/es/quickstart"
}
},
"groups": [
{
"group": "Comenzando",
"pages": ["es/quickstart", "es/index"]
}
]
}
]
}
}
```

Les propriétés `footer` et `navbar` propres à une langue remplacent les paramètres globaux pour cette langue. Si une langue ne définit pas ces propriétés, elle hérite de la configuration globale.

Vous pouvez également configurer un `banner` spécifique à chaque langue en utilisant le même schéma.

<div id="maintain-translations">
## Conserver les traductions
</div>
Expand Down
50 changes: 49 additions & 1 deletion fr/organize/navigation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -552,7 +552,7 @@ Répartissez votre navigation en différentes langues. Les langues peuvent être
alt="Graphique décoratif d’un sélecteur de langue."
/>

Dans l’objet `navigation`, `languages` est un tableau où chaque entrée est un objet qui requiert un champ `language` et peut contenir tout autre champ de navigation, y compris des configurations de bannière spécifiques à la langue.
Dans l’objet `navigation`, `languages` est un tableau où chaque entrée est un objet qui requiert un champ `language` et peut contenir tout autre champ de navigation, y compris des configurations de bannière, de footer et de navbar spécifiques à la langue.

Nous prenons actuellement en charge les langues suivantes pour la localisation :

Expand Down Expand Up @@ -596,6 +596,30 @@ Nous prenons actuellement en charge les langues suivantes pour la localisation :
"content": "🚀 Version 2.0 is now live! See our [changelog](/en/changelog) for details.",
"dismissible": true
},
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Resources",
"items": [
{ "label": "Documentation", "href": "/en/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Docs", "href": "/en/docs" }
],
"primary": {
"type": "button",
"label": "Get Started",
"href": "/en/quickstart"
}
},
"groups": [
{
"group": "Getting started",
Expand All @@ -609,6 +633,30 @@ Nous prenons actuellement en charge les langues suivantes pour la localisation :
"content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/es/changelog).",
"dismissible": true
},
"footer": {
"socials": {
"x": "https://x.com/mintlify"
},
"links": [
{
"header": "Recursos",
"items": [
{ "label": "Documentación", "href": "/es/docs" },
{ "label": "Blog", "href": "https://mintlify.com/blog" }
]
}
]
},
"navbar": {
"links": [
{ "label": "Documentación", "href": "/es/docs" }
],
"primary": {
"type": "button",
"label": "Comenzar",
"href": "/es/quickstart"
}
},
"groups": [
{
"group": "Getting started",
Expand Down
Loading