From cd1886fd78e87413637f3a91de8d4adb8e1a69dc Mon Sep 17 00:00:00 2001 From: "locadex-agent[bot]" <217277504+locadex-agent[bot]@users.noreply.github.com> Date: Tue, 30 Sep 2025 20:40:50 +0000 Subject: [PATCH] docs(locadex): update translations --- es/code.mdx | 4 +- es/components/code-groups.mdx | 51 +++++++------- es/settings.mdx | 109 ++++++++++++++++++++--------- fr/code.mdx | 4 +- fr/components/code-groups.mdx | 47 ++++++------- fr/settings.mdx | 107 +++++++++++++++++++++-------- zh/code.mdx | 6 +- zh/components/code-groups.mdx | 49 +++++++------ zh/settings.mdx | 125 +++++++++++++++++++++++----------- 9 files changed, 320 insertions(+), 182 deletions(-) diff --git a/es/code.mdx b/es/code.mdx index ee1fc9a5e..ca64949cd 100644 --- a/es/code.mdx +++ b/es/code.mdx @@ -73,6 +73,8 @@ Activa el resaltado de sintaxis especificando el lenguaje de programación despu Usamos [Shiki](https://shiki.style/) para el resaltado de sintaxis y admitimos todos los lenguajes disponibles. Consulta la lista completa de [lenguajes](https://shiki.style/languages) en la documentación de Shiki. +Personaliza globalmente los temas de los bloques de código usando `styling.codeblocks` en tu archivo `docs.json`. Establece temas simples como `system` o `dark`, o configura [temas de Shiki](https://shiki.style/themes) personalizados para los modos claro y oscuro. Consulta [Configuración](/es/settings#styling) para ver las opciones disponibles. + ```java Ejemplo de resaltado de sintaxis class HelloWorld { @@ -82,7 +84,7 @@ Usamos [Shiki](https://shiki.style/) para el resaltado de sintaxis y admitimos t } ``` - ````mdx Formato + ````mdx Format ```java class HelloWorld { public static void main(String[] args) { diff --git a/es/components/code-groups.mdx b/es/components/code-groups.mdx index 688ea738d..c02e9a89e 100644 --- a/es/components/code-groups.mdx +++ b/es/components/code-groups.mdx @@ -4,51 +4,49 @@ description: "Muestra varios ejemplos de código en un solo componente" icon: "group" --- -Usa el componente `CodeGroup` para mostrar varios bloques de código en una interfaz con pestañas, lo que permite a los usuarios comparar implementaciones en distintos lenguajes de programación o ver enfoques alternativos para la misma tarea. +Usa el componente `CodeGroup` para mostrar varios bloques de código en una interfaz con Tabs, lo que permite a los usuarios comparar implementaciones en distintos lenguajes de programación o ver enfoques alternativos para la misma tarea. + ```javascript helloWorld.js + console.log("Hello World"); + ``` -```javascript helloWorld.js -console.log("Hello World"); -``` - -```python hello_world.py -print('Hello World!') -``` - -```java HelloWorld.java -class HelloWorld { - public static void main(String[] args) { - System.out.println("Hello, World!"); - } -} -``` + ```python hello_world.py + print('Hello World!') + ``` + ```java HelloWorld.java + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` - +Los grupos de código heredan los estilos globales de tu archivo `docs.json`. Personaliza tu tema usando `styling.codeblocks`. Consulta [Settings](/es/settings#styling) para ver las opciones de configuración.
## Creación de grupos de código
-Para crear un grupo de código, envuelve varios bloques de código con las etiquetas ``. Cada bloque de código debe incluir un título, que se convertirá en la etiqueta de la pestaña. +Para crear un grupo de código, envuelve varios bloques de código con etiquetas ``. Cada bloque de código debe incluir un título, que se convertirá en la etiqueta de la Tab. ````mdx ```javascript helloWorld.js -console.log("Hello World"); +console.log("Hola Mundo"); ``` ```python hello_world.py -print('Hello World!') +print('¡Hola Mundo!') ``` ```java HelloWorld.java class HelloWorld { public static void main(String[] args) { - System.out.println("Hello, World!"); + System.out.println("¡Hola, Mundo!"); } } ``` @@ -56,12 +54,11 @@ class HelloWorld { ```` -
- ## Menú de idioma + ## Menú desplegable de idiomas
-Puedes reemplazar las pestañas de un grupo de código por un menú desplegable para alternar entre idiomas usando la prop `dropdown`. +Puedes sustituir las pestañas de un grupo de código por un menú desplegable para cambiar entre idiomas usando la prop `dropdown`. ```javascript helloWorld.js @@ -85,17 +82,17 @@ Puedes reemplazar las pestañas de un grupo de código por un menú desplegable ```javascript helloWorld.js -console.log("Hola, mundo"); +console.log("Hola Mundo"); ``` ```python hello_world.py -print('Hola, mundo!') +print('¡Hola Mundo!') ``` ```java HelloWorld.java class HelloWorld { public static void main(String[] args) { - System.out.println("Hola, mundo!"); + System.out.println("¡Hola, Mundo!"); } } ``` diff --git a/es/settings.mdx b/es/settings.mdx index 308e7a839..99761f54d 100644 --- a/es/settings.mdx +++ b/es/settings.mdx @@ -47,7 +47,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. El tema de diseño de tu sitio. - Una de las siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`. + Una de las siguientes opciones: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`. Consulta [Temas](es/themes) para más información. @@ -57,23 +57,23 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Los colores usados en tu documentación. Los colores se aplican de forma diferente según el tema. Si solo proporcionas un color principal, se usará para todos los elementos de color. + Los colores usados en tu documentación. Se aplican de forma distinta según el tema. Si solo proporcionas un color principal, se usará para todos los elementos de color. - El color principal de tu documentación. Generalmente se usa para resaltar en el modo claro, con alguna variación según el tema. + El color principal de tu documentación. Generalmente se usa para resaltar en el modo claro, con algunas variaciones según el tema. Debe ser un código hexadecimal que comience con `#`. - El color usado para el énfasis en el modo oscuro. + El color usado para resaltar en el modo oscuro. Debe ser un código hexadecimal que comience con `#`. - El color usado para botones y estados de hover en los modos claro y oscuro, con alguna variación según el tema. + El color usado para botones y estados de hover en los modos claro y oscuro, con algunas variaciones según el tema. Debe ser un código hexadecimal que comience con `#`. @@ -81,7 +81,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Descripción de tu sitio para SEO e indexación en IA. + Descripción de tu sitio para SEO e indexación por IA. @@ -97,13 +97,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - La URL a la que redirigir al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a tu página de inicio. Ejemplo: `https://mintlify.com` + La URL a la que se redirige al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a tu página de inicio. Ejemplo: `https://mintlify.com` - Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon apropiados. + Ruta a tu archivo de favicon, incluida la extensión. Se redimensiona automáticamente a los tamaños de favicon adecuados. Puede ser un único archivo o archivos separados para los modos claro y oscuro. Ejemplo: `/favicon.png` @@ -118,7 +118,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Personalización de miniaturas para redes sociales y vistas previas de página. + Personalización de miniaturas para redes sociales y vistas previas de páginas. @@ -126,7 +126,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Imagen de fondo para tus miniaturas. Puede ser una ruta relativa o una URL absoluta. + Imagen de fondo de tus miniaturas. Puede ser una ruta relativa o una URL absoluta. @@ -136,24 +136,71 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - 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`. + 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. De forma predeterminada es `section`. - - El tema de los bloques de código. Elige `system` para que coincida con el tema del sitio o `dark` para bloques de código siempre oscuros. El valor predeterminado es `system`. + + Configuración del tema de los bloques de código. De forma predeterminada es `"system"`. + + **Configuración simple:** + + * `"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) por separado para los modos claro y oscuro + + + Un único nombre de tema de Shiki para usar tanto en modo claro como en modo oscuro. + + ```json + "styling": { + "codeblocks": { + "theme": "dracula" + } + } + ``` + + + + Temas separados para los modos claro y oscuro. + + + + Un nombre de tema de Shiki para el modo claro. + + + + Un nombre de tema de Shiki para el modo oscuro. + + + ```json + "styling": { + "codeblocks": { + "theme": { + "light": "github-light", + "dark": "github-dark" + } + } + } + ``` + + - Configuración de la biblioteca de íconos. + Configuración de la biblioteca de iconos. - Biblioteca de íconos que se usará en toda tu documentación. De forma predeterminada es `fontawesome`. + Biblioteca de iconos para usar en toda tu documentación. De forma predeterminada es `fontawesome`. - Puedes especificar una URL a un ícono alojado externamente, la 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 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. @@ -162,17 +209,17 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Configuración de fuentes para tu documentación. La fuente predeterminada es [Inter](https://fonts.google.com/specimen/Inter). - + Familia tipográfica, por ejemplo, "Open Sans". - Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Grosor de la fuente, como 400 o 700. Las fuentes variables admiten grosores precisos como 550. - URL del origen de la fuente, por ejemplo, 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 source. + URL de origen de la 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 source. @@ -180,19 +227,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Anula la configuración de la fuente específicamente para los encabezados. + Sobrescribe la configuración de fuentes específicamente para los encabezados. - + Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display". - Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Grosor de la fuente, como 400 o 700. Las fuentes variables admiten grosores precisos como 550. - URL del origen de la fuente, por ejemplo, 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 source. + URL de origen de la 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 source. @@ -202,19 +249,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Anula la configuración de la fuente específicamente para el texto del cuerpo. + Sobrescribe la configuración de fuentes específicamente para el texto del cuerpo. - + Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display". - Peso de la fuente, por ejemplo, 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Grosor de la fuente, como 400 o 700. Las fuentes variables admiten grosores precisos como 550. - URL del origen de la fuente, por ejemplo, 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 source. + URL de origen de la 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 source. @@ -226,15 +273,15 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Configuración del conmutador de modo claro/oscuro. + Configuración del cambio de modo claro/oscuro. - + - Modo de tema predeterminado. Elige `system` para ajustarte a la configuración del SO del usuario, o `light` o `dark` para forzar un modo específico. De forma predeterminada es `system`. + Modo de tema predeterminado. Elige `system` para que coincida con la configuración del sistema operativo del usuario, o `light` o `dark` para forzar un modo específico. De manera predeterminada es `system`. - Si se debe ocultar el conmutador de modo claro/oscuro. De forma predeterminada es `true`. + Indica si se debe ocultar el cambio de modo claro/oscuro. El valor predeterminado es `true`. diff --git a/fr/code.mdx b/fr/code.mdx index bbe685dc1..b2eff28a9 100644 --- a/fr/code.mdx +++ b/fr/code.mdx @@ -69,10 +69,12 @@ Vous pouvez ajouter des options méta à vos code blocks pour personnaliser leur ### Coloration syntaxique -Activez la coloration syntaxique en indiquant le langage de programmation après les backticks d’ouverture d’un code block. +Activez la coloration syntaxique en indiquant le langage de programmation après les premiers backticks d’un code block. Nous utilisons [Shiki](https://shiki.style/) pour la coloration syntaxique et prenons en charge tous les langages disponibles. Consultez la liste complète des [langages](https://shiki.style/languages) dans la documentation de Shiki. +Personnalisez globalement les thèmes des code blocks via `styling.codeblocks` dans votre fichier `docs.json`. Définissez des thèmes simples comme `system` ou `dark`, ou configurez des [thèmes Shiki](https://shiki.style/themes) personnalisés pour les modes clair et sombre. Voir [Paramètres](/fr/settings#styling) pour les options de configuration. + ```java Exemple de coloration syntaxique class HelloWorld { diff --git a/fr/components/code-groups.mdx b/fr/components/code-groups.mdx index c9998b782..70c113b0d 100644 --- a/fr/components/code-groups.mdx +++ b/fr/components/code-groups.mdx @@ -7,48 +7,46 @@ icon: "group" Utilisez le composant `CodeGroup` pour afficher plusieurs blocs de code dans une interface à onglets, afin de permettre aux utilisateurs de comparer des implémentations dans différents langages de programmation ou d’examiner des approches alternatives pour une même tâche. + ```javascript helloWorld.js + console.log("Hello World"); + ``` -```javascript helloWorld.js -console.log("Hello World"); -``` - -```python hello_world.py -print('Hello World!') -``` - -```java HelloWorld.java -class HelloWorld { - public static void main(String[] args) { - System.out.println("Hello, World!"); - } -} -``` + ```python hello_world.py + print('Hello World!') + ``` + ```java HelloWorld.java + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` - +Les groupes de code héritent du style global défini dans votre fichier `docs.json`. Personnalisez votre thème avec `styling.codeblocks`. Consultez [Paramètres](/fr/settings#styling) pour les options de configuration.
- ## Créer des groupes de code + ## Création de groupes de code
-Pour créer un groupe de code, entourez plusieurs blocs de code avec des balises ``. Chaque bloc de code doit inclure un titre, qui deviendra le libellé de l’onglet. +Pour créer un groupe de code, enveloppez plusieurs code blocks avec des balises ``. Chaque code block doit inclure un Titre, qui devient le label de l’Onglet. ````mdx ```javascript helloWorld.js -console.log("Bonjour, monde !"); +console.log("Bonjour le monde"); ``` ```python hello_world.py -print('Bonjour, monde !') +print('Bonjour le monde !') ``` ```java HelloWorld.java class HelloWorld { public static void main(String[] args) { - System.out.println("Bonjour, monde !"); + System.out.println("Bonjour le monde !"); } } ``` @@ -56,12 +54,11 @@ class HelloWorld { ```` -
- ## Liste déroulante de langue + ## Menu déroulant de langue
-Vous pouvez remplacer les onglets d’un groupe de code par un menu déroulant pour basculer entre les langues en utilisant la prop `dropdown`. +Vous pouvez remplacer les onglets d’un groupe de code par un menu déroulant pour changer de langue à l’aide de la prop `dropdown`. ```javascript helloWorld.js @@ -81,7 +78,7 @@ Vous pouvez remplacer les onglets d’un groupe de code par un menu déroulant p ``` -````mdx surlignage=1 +````mdx highlight=1 ```javascript helloWorld.js diff --git a/fr/settings.mdx b/fr/settings.mdx index 3fd04f0a6..7c965f68b 100644 --- a/fr/settings.mdx +++ b/fr/settings.mdx @@ -49,7 +49,7 @@ Cette section présente la référence complète du fichier `docs.json`. L’un des suivants : `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`. - Voir [Themes](fr/themes) pour plus d’informations. + Voir [Thèmes](fr/themes) pour plus d’informations. @@ -57,17 +57,17 @@ Cette section présente la référence complète du fichier `docs.json`. - Les couleurs utilisées dans votre documentation. Leur application varie selon les thèmes. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés. + Les couleurs utilisées dans votre documentation. Elles s’appliquent différemment selon les thèmes. Si vous ne fournissez qu’une couleur principale, elle sera utilisée pour tous les éléments colorés. - + - La couleur principale de votre documentation. Généralement utilisée pour l’accentuation en mode clair, avec quelques variations selon le thème. + La couleur principale de votre documentation. Généralement utilisée pour la mise en avant en mode clair, avec quelques variations selon le thème. Doit être un code hexadécimal commençant par `#`. - La couleur utilisée pour l’accentuation en mode sombre. + La couleur utilisée pour la mise en avant en mode sombre. Doit être un code hexadécimal commençant par `#`. @@ -97,13 +97,13 @@ Cette section présente la référence complète du fichier `docs.json`. - L’URL vers laquelle rediriger lors d’un clic sur le logo. Si non renseigné, le logo pointera vers votre page d’accueil. Exemple : `https://mintlify.com` + L’URL vers laquelle rediriger lors d’un clic sur le logo. Si aucun lien n’est fourni, le logo renverra vers votre page d’accueil. Exemple : `https://mintlify.com` - Chemin vers votre fichier favicon, incluant l’extension. Redimensionné automatiquement aux tailles appropriées. + Chemin vers votre fichier favicon, extension incluse. Redimensionné automatiquement aux tailles de favicon appropriées. Peut être un fichier unique ou des fichiers distincts pour les modes clair et sombre. Exemple : `/favicon.png` @@ -120,13 +120,13 @@ Cette section présente la référence complète du fichier `docs.json`. Personnalisation des vignettes pour les réseaux sociaux et les aperçus de page. - + - Le thème visuel de vos vignettes. S’il n’est pas spécifié, les vignettes utilisent le jeu de couleurs de votre site défini par le champ `colors`. + Le thème visuel de vos vignettes. S’il n’est pas précisé, elles utilisent le jeu de couleurs de votre site défini par le champ `colors`. - Image d’arrière-plan pour vos vignettes. Peut être un chemin relatif ou une URL absolue. + Image d’arrière-plan de vos vignettes. Peut être un chemin relatif ou une URL absolue. @@ -136,11 +136,58 @@ Cette section présente la référence complète du fichier `docs.json`. - 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. Valeur par défaut : `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. Valeur par défaut : `section`. - - Le thème des blocs de code. Choisissez `system` pour correspondre au thème du site ou `dark` pour des blocs de code toujours sombres. Valeur par défaut : `system`. + + Configuration du thème des code blocks. Valeur par défaut : `"system"`. + + **Configuration simple :** + + * `"system"` : faire correspondre 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 code blocks + * Utilisez un objet pour spécifier des [thèmes Shiki](https://shiki.style/themes) distincts pour les modes clair et sombre + + + Un nom de thème Shiki unique à utiliser pour les modes clair et sombre. + + ```json + "styling": { + "codeblocks": { + "theme": "dracula" + } + } + ``` + + + + Thèmes distincts pour les modes clair et sombre. + + + + Un nom de thème Shiki pour le mode clair. + + + + Un nom de thème Shiki pour le mode sombre. + + + ```json + "styling": { + "codeblocks": { + "theme": { + "light": "github-light", + "dark": "github-dark" + } + } + } + ``` + + @@ -148,12 +195,12 @@ Cette section présente la référence complète du fichier `docs.json`. Paramètres de la bibliothèque d’icônes. - + - Bibliothèque d’icônes utilisée dans l’ensemble de votre documentation. Par défaut : `fontawesome`. + Bibliothèque d’icônes à utiliser dans l’ensemble de votre documentation. Valeur par défaut : `fontawesome`. - Vous pouvez indiquer une URL vers une icône hébergée en externe, un chemin de fichier d’icône dans votre projet, ou du code SVG (Scalable Vector Graphics) compatible JSX pour n’importe quelle icône, quel que soit le paramétrage de la bibliothèque. + Vous pouvez spécifier une URL vers une icône hébergée en externe, un chemin vers un fichier d’icône dans votre projet, ou du code SVG compatible JSX pour n’importe quelle icône individuelle, indépendamment du réglage de la bibliothèque. @@ -164,15 +211,15 @@ Cette section présente la référence complète du fichier `docs.json`. - Famille de polices, par exemple « Open Sans ». + Famille de polices, par exemple « Open Sans ». - Graisse (épaisseur) de la police, par exemple 400 ou 700. Les polices variables acceptent des valeurs précises comme 550. + Graisse/épaisseur de la police, par exemple 400 ou 700. Les polices variables permettent des valeurs précises comme 550. - URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous renseignez un nom de `family` Google Font, aucune URL de source n’est donc nécessaire. + URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous indiquez un nom de `family` Google Fonts, donc aucune URL source n’est nécessaire. @@ -180,19 +227,19 @@ Cette section présente la référence complète du fichier `docs.json`. - Remplace les paramètres de police spécifiquement pour les titres. + Remplacer les paramètres de police spécifiquement pour les titres. - Famille de polices, par exemple « Open Sans », « Playfair Display ». + Famille de polices, par exemple « Open Sans », « Playfair Display ». - Graisse (épaisseur) de la police, par exemple 400, 700. Les polices variables acceptent des valeurs précises comme 550. + Graisse/épaisseur de la police, par exemple 400 ou 700. Les polices variables permettent des valeurs précises comme 550. - URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous renseignez un nom de `family` Google Font, aucune URL de source n’est donc nécessaire. + URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous indiquez un nom de `family` Google Fonts, donc aucune URL source n’est nécessaire. @@ -202,19 +249,19 @@ Cette section présente la référence complète du fichier `docs.json`. - Remplace les paramètres de police spécifiquement pour le texte courant. + Remplacer les paramètres de police spécifiquement pour le texte courant. - Famille de polices, par exemple « Open Sans », « Playfair Display ». + Famille de polices, par exemple « Open Sans », « Playfair Display ». - Graisse (épaisseur) de la police, par exemple 400, 700. Les polices variables acceptent des valeurs précises comme 550. + Graisse/épaisseur de la police, par exemple 400 ou 700. Les polices variables permettent des valeurs précises comme 550. - URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous renseignez un nom de `family` Google Font, aucune URL de source n’est donc nécessaire. + URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2. [Google Fonts](https://fonts.google.com) sont chargées automatiquement lorsque vous indiquez un nom de `family` Google Fonts, donc aucune URL source n’est nécessaire. @@ -226,15 +273,15 @@ Cette section présente la référence complète du fichier `docs.json`. - Paramètres de la bascule de mode clair/sombre. + Paramètres de l’option de mode clair/sombre. - Mode de thème par défaut. Choisissez `system` pour suivre le réglage du système d’exploitation de l’utilisateur, ou `light`/`dark` pour imposer un mode spécifique. Par défaut : `system`. + Mode de thème par défaut. Choisissez `system` pour respecter les réglages du système d’exploitation de l’utilisateur, ou `light`/`dark` pour imposer un mode spécifique. Par défaut, `system`. - Indique s’il faut masquer la bascule clair/sombre. Par défaut : `true`. + Indique s’il faut masquer l’interrupteur de mode clair/sombre. Par défaut, `true`. diff --git a/zh/code.mdx b/zh/code.mdx index 48ddcbe30..95d113b44 100644 --- a/zh/code.mdx +++ b/zh/code.mdx @@ -69,9 +69,11 @@ icon: "code" ### 语法高亮 -在代码块起始的三个反引号后指定编程语言即可启用语法高亮。 +在代码块的起始反引号后添加编程语言以启用语法高亮。 -我们使用 [Shiki](https://shiki.style/) 提供语法高亮，支持其所有可用语言。完整列表请参见 Shiki 文档中的[语言](https://shiki.style/languages)。 +我们使用 [Shiki](https://shiki.style/) 实现语法高亮，并支持其提供的所有语言。完整列表请参见 Shiki 文档中的[语言](https://shiki.style/languages)。 + +在 `docs.json` 文件中通过 `styling.codeblocks` 全局自定义代码块主题。你可以设置 `system` 或 `dark` 等简单主题，或为浅色与深色模式配置自定义的 [Shiki 主题](https://shiki.style/themes)。配置选项见 [Settings](/zh/settings#styling)。 ```java 语法高亮示例 diff --git a/zh/components/code-groups.mdx b/zh/components/code-groups.mdx index 97bb13328..144f08d24 100644 --- a/zh/components/code-groups.mdx +++ b/zh/components/code-groups.mdx @@ -1,48 +1,46 @@ --- -title: "代码组" -description: "在单个组件中展示多个代码示例" +title: "代码分组" +description: "在一个组件中展示多个代码示例" icon: "group" --- -使用 `CodeGroup` 组件在带有标签页的界面中展示多个代码块，方便用户对比不同编程语言的实现，或查看同一任务的替代实现。 +使用 `CodeGroup` 组件在标签式界面中展示多个代码块，便于用户对比不同编程语言的实现，或查看完成同一任务的替代方案。 + ```javascript helloWorld.js + console.log("Hello World"); + ``` -```javascript helloWorld.js -console.log("Hello World"); -``` - -```python hello_world.py -print('Hello World!') -``` - -```java HelloWorld.java -class HelloWorld { - public static void main(String[] args) { - System.out.println("Hello, World!"); - } -} -``` + ```python hello_world.py + print('Hello World!') + ``` + ```java HelloWorld.java + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` - +代码分组会继承 `docs.json` 中的全局样式。可通过 `styling.codeblocks` 自定义主题。配置项参见 [Settings](/zh/settings#styling)。
## 创建代码组
-要创建代码组，请用 `` 标签包裹多个代码块。每个代码块必须包含一个标题，该标题将作为选项卡的标签显示。 +要创建代码组，请使用 `` 标签包裹多个代码块。每个代码块必须包含一个 title，其值将作为标签页的标签。 ````mdx ```javascript helloWorld.js -console.log("你好，世界"); +console.log("你好世界"); ``` ```python hello_world.py -print('你好，世界！') +print('你好世界!') ``` ```java HelloWorld.java @@ -56,12 +54,11 @@ class HelloWorld { ```` -
## 语言下拉菜单
-你可以使用 `dropdown` 属性将代码组中的标签页替换为下拉菜单，以在不同语言间切换。 +你可以通过使用 `dropdown` 属性，将 CodeGroup 中的选项卡替换为下拉菜单，以在不同语言之间切换。 ```javascript helloWorld.js @@ -85,11 +82,11 @@ class HelloWorld { ```javascript helloWorld.js -console.log("你好，世界"); +console.log("你好世界"); ``` ```python hello_world.py -print('你好，世界！') +print('你好世界!') ``` ```java HelloWorld.java diff --git a/zh/settings.mdx b/zh/settings.mdx index 0c6846577..303bab6ed 100644 --- a/zh/settings.mdx +++ b/zh/settings.mdx @@ -47,9 +47,9 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; 站点的布局主题。 - 以下之一：`mint`、`maple`、`palm`、`willow`、`linden`、`almond`、`aspen`。 + 可选项：`mint`、`maple`、`palm`、`willow`、`linden`、`almond`、`aspen`。 - 更多信息请参阅 [Themes](zh/themes)。 + 详见 [Themes](zh/themes)。 @@ -61,72 +61,72 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 文档的主色。通常在浅色模式下用于强调，具体因主题而异。 + 文档的主色。通常用于浅色模式中的强调效果，具体随主题有所差异。 - 必须是以 `#` 开头的十六进制色值。 + 必须为以 `#` 开头的十六进制色值。 深色模式下用于强调的颜色。 - 必须是以 `#` 开头的十六进制色值。 + 必须为以 `#` 开头的十六进制色值。 - 在浅色与深色模式下用于按钮和悬停状态的颜色，具体因主题而异。 + 浅色与深色模式下按钮与悬停状态所用的颜色，具体随主题有所差异。 - 必须是以 `#` 开头的十六进制色值。 + 必须为以 `#` 开头的十六进制色值。 - 用于 SEO（搜索引擎优化）和 AI 索引编入的站点说明。 + 面向 SEO（搜索引擎优化）与 AI 索引编入的站点说明。 - 适用于浅色和深色模式的徽标。 + 适用于浅色与深色模式的徽标。 - 指向浅色模式徽标文件的路径。需包含文件扩展名。示例：`/logo.png` + 指向浅色模式徽标文件的路径，需包含文件扩展名。示例：`/logo.png` - 指向深色模式徽标文件的路径。需包含文件扩展名。示例：`/logo-dark.png` + 指向深色模式徽标文件的路径，需包含文件扩展名。示例：`/logo-dark.png` - 点击徽标时跳转的 URL。若未提供，徽标将链接到您的首页。示例：`https://mintlify.com` + 点击徽标时跳转的 URL。如未提供，徽标将链接至您的首页。示例：`https://mintlify.com` - 指向 favicon 文件的路径，需包含文件扩展名。会自动调整为合适的 favicon 尺寸。 - 可为单个文件，或分别为浅色与深色模式提供文件。示例：`/favicon.png` + 指向 favicon 文件的路径，需包含文件扩展名。将自动调整为合适的 favicon 尺寸。 + 可为单个文件，或分别为浅色/深色模式提供文件。示例：`/favicon.png` - 指向浅色模式 favicon 文件的路径。需包含文件扩展名。示例：`/favicon.png` + 指向浅色模式 favicon 文件的路径，需包含文件扩展名。示例：`/favicon.png` - 指向深色模式 favicon 文件的路径。需包含文件扩展名。示例：`/favicon-dark.png` + 指向深色模式 favicon 文件的路径，需包含文件扩展名。示例：`/favicon-dark.png` - 用于社交媒体与页面预览的缩略图自定义。 + 社交媒体与页面预览的缩略图自定义。 - 缩略图的视觉主题。若未指定，将使用由 `colors` 字段定义的站点配色方案。 + 缩略图的视觉主题。若未指定，将使用 `colors` 字段定义的站点配色方案。 - 缩略图的背景图像。可为相对路径或绝对 URL。 + 缩略图背景图像。可为相对路径或绝对 URL。 @@ -136,11 +136,58 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 页面眉的样式。选择 `section` 显示分区名称，或选择 `breadcrumbs` 显示完整导航路径。默认为 `section`。 + 页面 eyebrow 的样式。选择 `section` 显示章节名称，或选择 `breadcrumbs` 显示完整导航路径。默认值为 `section`。 - - 代码块的主题。选择 `system` 以匹配站点主题，或选择 `dark` 始终使用深色代码块。默认为 `system`。 + + 代码块主题配置。默认值为 `"system"`。 + + **简单配置：** + + * `"system"`：跟随当前站点模式（浅色或深色） + * `"dark"`：始终使用深色模式 + + **自定义主题配置：** + + * 使用字符串为所有代码块指定一个 [Shiki 主题](https://shiki.style/themes) + * 使用对象分别为浅色和深色模式指定 [Shiki 主题](https://shiki.style/themes) + + + 一个同时用于浅色与深色模式的 Shiki 主题名称。 + + ```json + "styling": { + "codeblocks": { + "theme": "dracula" + } + } + ``` + + + + 分别为浅色和深色模式设置主题。 + + + + 浅色模式的 Shiki 主题名称。 + + + + 深色模式的 Shiki 主题名称。 + + + ```json + "styling": { + "codeblocks": { + "theme": { + "light": "github-light", + "dark": "github-dark" + } + } + } + ``` + + @@ -150,29 +197,29 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 在整站文档中使用的图标库。默认为 `fontawesome`。 + 文档全站使用的图标库。默认值为 `fontawesome`。 - 无论库设置如何，你都可以为任意单个图标指定外部托管图标的 URL、项目中图标文件的路径，或兼容 JSX 的 SVG 代码。 + 无论库设置如何，您都可以为任意单个图标指定外部托管图标的 URL、项目中图标文件的路径，或兼容 JSX 的 SVG 代码。 - 文档的字体配置。默认字体为 [Inter](https://fonts.google.com/specimen/Inter)。 + 文档站点的字体配置。默认字体为 [Inter](https://fonts.google.com/specimen/Inter)。 - 字体系列，例如 “Open Sans”。 + 字体系列，例如“Open Sans”。 - 字重，例如 400 或 700。可变字体支持更精确的字重，例如 550。 + 字重，例如 400 或 700。可变字体支持更精细的字重，例如 550。 - 字体来源的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。 当你指定 Google 字体的 `family` 名称时，[Google Fonts](https://fonts.google.com) 会自动加载，因此无需提供来源 URL。 + 字体源文件的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com)，因此无需提供 source 的 URL。 @@ -180,19 +227,19 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 专用于标题的字体覆盖设置。 + 专用于标题的字体设置覆盖。 - 字体系列，例如 “Open Sans”“Playfair Display”。 + 字体系列，例如“Open Sans”、“Playfair Display”。 - 字重，例如 400、700。可变字体支持更精确的字重，例如 550。 + 字重，例如 400、700。可变字体支持更精细的字重，例如 550。 - 字体来源的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。 当你指定 Google 字体的 `family` 名称时，[Google Fonts](https://fonts.google.com) 会自动加载，因此无需提供来源 URL。 + 字体源文件的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com)，因此无需提供 source 的 URL。 @@ -202,19 +249,19 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 专用于正文的字体覆盖设置。 + 专用于正文的字体设置覆盖。 - 字体系列，例如 “Open Sans”“Playfair Display”。 + 字体系列，例如“Open Sans”、“Playfair Display”。 - 字重，例如 400、700。可变字体支持更精确的字重，例如 550。 + 字重，例如 400、700。可变字体支持更精细的字重，例如 550。 - 字体来源的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。 当你指定 Google 字体的 `family` 名称时，[Google Fonts](https://fonts.google.com) 会自动加载，因此无需提供来源 URL。 + 字体源文件的 URL，例如 https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2。指定 Google 字体的 `family` 名称时会自动加载 [Google Fonts](https://fonts.google.com)，因此无需提供 source 的 URL。 @@ -226,15 +273,15 @@ import IconsOptional from "/snippets/zh/icons-optional.mdx"; - 明暗模式切换设置。 + 明/暗模式切换设置。 - 默认主题模式。选择 `system` 以匹配用户的操作系统设置，或选择 `light` 或 `dark` 以强制使用特定模式。默认为 `system`。 + 默认主题模式。选择 `system` 以匹配用户的操作系统设置，或选择 `light` 或 `dark` 以强制特定模式。默认值为 `system`。 - 是否隐藏明暗模式切换。默认为 `true`。 + 是否隐藏明/暗模式切换。默认值为 `true`。