diff --git a/es/index.mdx b/es/index.mdx index e48e3eb49..608a62108 100644 --- a/es/index.mdx +++ b/es/index.mdx @@ -1,6 +1,6 @@ --- title: "Introducción" -description: "Descubre la próxima generación de documentación: nativa de IA, hermosa desde el primer momento y creada para desarrolladores." +description: "Descubre la próxima generación de documentación. Nativa de IA, atractiva desde el primer momento y creada para desarrolladores." mode: "custom" --- @@ -25,9 +25,9 @@ export const HeroCard = ({ filename, title, description, href }) => {
- + Imagen de fondo decorativa. - + Imagen de fondo decorativa.
@@ -36,7 +36,7 @@ export const HeroCard = ({ filename, title, description, href }) => {
- Descubre la próxima generación de documentación. Nativa de IA, atractiva desde el primer momento y creada para desarrolladores. + Descubre la próxima generación de documentación: nativa de IA, atractiva desde el primer momento y creada para desarrolladores.
@@ -44,9 +44,9 @@ export const HeroCard = ({ filename, title, description, href }) => { - + - +
diff --git a/es/installation.mdx b/es/installation.mdx index 5dcdbaf93..085db5e02 100644 --- a/es/installation.mdx +++ b/es/installation.mdx @@ -3,9 +3,9 @@ title: "Instalación de la CLI" description: "Instala la CLI para previsualizar y desarrollar tu documentación de forma local" --- - +Gráfico decorativo que representa la CLI. - +Gráfico decorativo que representa la CLI.
## Instalación de la CLI diff --git a/es/integrations/analytics/google-analytics.mdx b/es/integrations/analytics/google-analytics.mdx index efb519c09..9c7dfd1d7 100644 --- a/es/integrations/analytics/google-analytics.mdx +++ b/es/integrations/analytics/google-analytics.mdx @@ -2,35 +2,33 @@ title: "Google Analytics 4" --- -Deberás generar una nueva propiedad de GA4 para usar con Mintlify. Los datos recopilados se enviarán al mismo proyecto que tus otros datos de Google Analytics. - -Si usas la versión anterior de Google Analytics, Universal Analytics, aún podrás generar una propiedad de GA4. Los datos de GA4 son ligeramente diferentes de los de UA, pero igual se recopilan en el mismo proyecto. - +Necesitas generar una nueva propiedad de GA4 para usar con Mintlify. Los datos recopilados se enviarán al mismo proyecto que tus otros datos de Google Analytics. +Si usas la versión anterior de Google Analytics, Universal Analytics, aún podrás generar una propiedad de GA4. Los datos de GA4 son ligeramente diferentes de los de UA, pero se siguen recopilando en el mismo proyecto.
- ## Cómo conectar GA4 a Mintlify + ## Cómo conectar GA4 con Mintlify
### Crear un flujo web
-Necesitas crear un flujo web para obtener el ID de medición que debes agregar en Mintlify. +Necesitas crear un flujo web para obtener el ID de medición que debes ingresar en Mintlify. -Haz clic en el engranaje en la esquina inferior izquierda de la pantalla de Google Analytics. Luego, haz clic en Data Streams. +Haz clic en el ícono de engranaje en la parte inferior izquierda de la pantalla de Google Analytics. Luego, haz clic en Data Streams. -![](/images/ga4-web-streams.png) +![Captura de pantalla de la página Data Streams en el dashboard de Google Analytics.](/images/ga4-web-streams.png) -Crea un flujo web y coloca la URL de tu sitio de documentación de Mintlify como la URL del flujo. +Crea un flujo web y establece la URL de tu sitio de documentación de Mintlify como la URL del flujo. Tu ID de medición tiene el formato `G-XXXXXXX` y aparecerá en Stream Details inmediatamente después de crear el flujo web.
- ### Agregar el ID de medición en docs.json + ### Coloca el Measurement ID en docs.json
-Agrega tu ID de medición a tu archivo `docs.json` de la siguiente manera: +Añade tu Measurement ID a tu archivo `docs.json` de la siguiente manera: ```json docs.json "integrations": { @@ -40,14 +38,17 @@ Agrega tu ID de medición a tu archivo `docs.json` de la siguiente manera: } ``` +
### Espera
Google Analytics tarda entre dos y tres días en mostrar tus datos. -Puedes usar [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar que Analytics esté habilitado correctamente. La extensión registrará en la consola de tu navegador cada vez que GA4 realice una solicitud. +Puedes usar [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) para comprobar que Analytics está habilitado correctamente. La extensión registrará en la consola de tu navegador cada vez que GA4 realice una solicitud. - Los enlaces de vista previa tienen Analytics desactivado. - + +Los enlaces de vista previa tienen desactivado Analytics. + + \ No newline at end of file diff --git a/es/organize/navigation.mdx b/es/organize/navigation.mdx index 637f014cc..291608747 100644 --- a/es/organize/navigation.mdx +++ b/es/organize/navigation.mdx @@ -13,11 +13,11 @@ Con una configuración de navegación adecuada, puedes organizar tu contenido pa Las páginas son el componente de navegación más fundamental. Las páginas se corresponden con los archivos MDX que conforman tu documentación. - +Gráfico decorativo de páginas. - +Gráfico decorativo de páginas. -En el objeto `navigation`, `pages` es un arreglo donde cada entrada debe referenciar la ruta a un [archivo de página](es/pages). +En el objeto `navigation`, `pages` es un array donde cada entrada debe hacer referencia a la ruta de un [archivo de página](es/pages). ```json { @@ -37,13 +37,13 @@ En el objeto `navigation`, `pages` es un arreglo donde cada entrada debe referen ## Grupos
-Usa grupos para organizar la navegación de la barra lateral en secciones. Los grupos pueden anidarse, etiquetarse con tags y personalizarse con icon. +Usa grupos para organizar la navegación de tu barra lateral en secciones. Los grupos pueden anidarse entre sí, etiquetarse con tags y personalizarse con iconos. - +Gráfico decorativo de grupos. - +Gráfico decorativo de grupos. -En el objeto `navigation`, `groups` es un array donde cada entrada es un objeto que requiere un campo `group` y un campo `pages`. Los campos `icon`, `tag` y `expanded` son opcionales. +En el objeto `navigation`, `groups` es un arreglo en el que cada entrada es un objeto que requiere un campo `group` y un campo `pages`. Los campos `icon`, `tag` y `expanded` son opcionales. ```json { @@ -68,7 +68,7 @@ En el objeto `navigation`, `groups` es un array donde cada entrada es un objeto { "group": "Escribiendo contenido", "icon": "notebook-text", - "tag": "NEW", + "tag": "NUEVO", "pages": [ "writing-content/page", "writing-content/text" @@ -97,13 +97,13 @@ Establece `expanded: true` en un grupo para que se muestre expandido por defecto ## Tabs -Tabs crean secciones diferenciadas de tu documentación con rutas de URL independientes. Tabs crean una barra de navegación horizontal en la parte superior de tu documentación que permite a los usuarios cambiar entre secciones. +Las Tabs crean secciones diferenciadas de tu documentación con rutas de URL independientes. Las Tabs generan una barra de navegación horizontal en la parte superior de tu documentación que permite a los usuarios cambiar entre secciones. - +Gráfico decorativo de una navegación por pestañas. - +Gráfico decorativo de una navegación por pestañas. -En el objeto `navigation`, `tabs` es un array donde cada elemento es un objeto que requiere un campo `tab` y puede contener otros campos de navegación como groups, pages, icon o enlaces a páginas externas. +En el objeto `navigation`, `tabs` es un array donde cada entrada es un objeto que requiere un campo `tab` y puede contener otros campos de navegación como groups, pages, icon o enlaces a páginas externas. ```json { @@ -189,13 +189,13 @@ En el objeto `navigation`, `menu` es un array donde cada entrada es un objeto qu ## Anclas -Las anclas añaden elementos de navegación persistentes en la parte superior de tu barra lateral. Usa anclas para dividir tu contenido, ofrecer acceso rápido a recursos externos o crear llamados a la acción destacados. +Las anclas agregan elementos de navegación persistentes en la parte superior de tu barra lateral. Usa anclas para dividir tu contenido, ofrecer acceso rápido a recursos externos o crear llamadas a la acción destacadas. - +Gráfico decorativo de una navegación con anclas. - +Gráfico decorativo de una navegación con anclas. -En el objeto `navigation`, `anchors` es un arreglo donde cada entrada es un objeto que requiere un campo `anchor` y puede contener otros campos de navegación como groups, pages, icons o enlaces a páginas externas. +En el objeto `navigation`, `anchors` es un arreglo en el que cada entrada es un objeto que requiere un campo `anchor` y puede contener otros campos de navegación como groups, pages, icons o enlaces a páginas externas. ```json { @@ -228,7 +228,7 @@ En el objeto `navigation`, `anchors` es un arreglo donde cada entrada es un obje } ``` -Para los anclajes que dirigen únicamente a enlaces externos, usa la palabra clave `global`. Los anclajes en un objeto `global` deben tener un campo `href` y no pueden apuntar a una ruta relativa. +Para los anclajes que apuntan solo a enlaces externos, usa la palabra clave `global`. Los anclajes dentro de un objeto `global` deben tener un campo `href` y no pueden apuntar a una ruta relativa. Los anclajes globales son especialmente útiles para enlazar a recursos que no forman parte de tu documentación, pero que deberían estar fácilmente accesibles para tus usuarios, como un blog o un portal de soporte. @@ -258,13 +258,13 @@ Los anclajes globales son especialmente útiles para enlazar a recursos que no f ## Menús desplegables -Los menús desplegables se muestran en un menú expandible en la parte superior de la barra lateral de tu navegación. Cada elemento de un menú desplegable lleva a una sección de tu documentación. +Los menús desplegables se encuentran en un menú desplegable en la parte superior de la barra lateral de tu navigation. Cada elemento de un menú desplegable dirige a una sección de tu documentación. - +Gráfico decorativo de una navigation con menú desplegable. - +Gráfico decorativo de una navigation con menú desplegable. -En el objeto `navigation`, `dropdowns` es un arreglo donde cada entrada es un objeto que requiere un campo `dropdown` y puede contener otros campos de navegación como groups, páginas, iconos o enlaces a páginas externas. +En el objeto `navigation`, `dropdowns` es un array donde cada entrada es un objeto que requiere un campo `dropdown` y puede contener otros campos de navegación como groups, pages, icons o enlaces a páginas externas. ```json { @@ -301,20 +301,20 @@ En el objeto `navigation`, `dropdowns` es un arreglo donde cada entrada es un ob ## Productos - +Gráfico decorativo de un selector de productos. - +Gráfico decorativo de un selector de productos. -Los productos crean una sección de navegación dedicada para organizar la documentación específica de cada producto. Usa productos para separar diferentes ofertas, servicios o conjuntos de funcionalidades principales dentro de tu documentación. +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 elemento 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 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. ```json { "navigation": { "products": [ { - "product": "Core API", + "product": "API Principal", "icon": "api", "groups": [ { @@ -343,7 +343,7 @@ En el objeto `navigation`, `products` es un arreglo en el que cada elemento es u ] }, { - "product": "SDK para móviles", + "product": "SDK Móvil", "icon": "smartphone", "href": "https://mobile-sdk-docs.example.com" } @@ -393,13 +393,13 @@ Para obtener más información sobre cómo hacer referencia a endpoints de OpenA ## Versiones -Divide tu navigation en diferentes versiones. Se pueden seleccionar desde un menú desplegable. +Divide tu navigation en diferentes versiones. Puedes seleccionar la versión desde un menú desplegable. - +Gráfico decorativo de un selector de versión. - +Gráfico decorativo de un selector de versión. -En el objeto `navigation`, `versions` es un arreglo donde cada entrada es un objeto que requiere un campo `version` y puede contener cualquier otro campo de navigation. +En el objeto `navigation`, `versions` es un array en el que cada entrada es un objeto que requiere un campo `version` y puede contener cualquier otro campo de navegación. ```json { @@ -432,44 +432,44 @@ En el objeto `navigation`, `versions` es un arreglo donde cada entrada es un obj ## Idiomas -Divide tu navigation en diferentes idiomas. Puedes seleccionar los idiomas desde un menú desplegable. +Divide tu navigation en varios idiomas. Los idiomas se pueden seleccionar desde un menú desplegable. - +Gráfico decorativo de un selector de idioma. - +Gráfico decorativo de un selector de idioma. -En el objeto `navigation`, `languages` es un arreglo donde cada entrada es un objeto que requiere un campo `language` y puede incluir cualquier otro campo de navigation. +En el objeto `navigation`, `languages` es un arreglo donde cada elemento es un objeto que requiere un campo `language` y puede incluir cualquier otro campo de navegación. Actualmente admitimos los siguientes idiomas para la localización: - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> - } horizontal /> + } horizontal /> ```json diff --git a/fr/index.mdx b/fr/index.mdx index 3c46638c1..17f6baf56 100644 --- a/fr/index.mdx +++ b/fr/index.mdx @@ -1,6 +1,6 @@ --- title: "Introduction" -description: "Découvrez la nouvelle génération de documentation. Native à l’IA, belle dès le départ et conçue pour les développeurs." +description: "Découvrez la nouvelle génération de documentation. Native à l’IA, magnifique dès le départ et conçue pour les développeurs." mode: "custom" --- @@ -25,9 +25,9 @@ export const HeroCard = ({ filename, title, description, href }) => {
- + Image d’arrière-plan décorative. - + Image d’arrière-plan décorative.
@@ -36,15 +36,15 @@ export const HeroCard = ({ filename, title, description, href }) => {
- Découvrez la nouvelle génération de documentation. Nativement IA, superbe dès le départ, conçue pour les développeurs. + Découvrez la nouvelle génération de documentation. Native IA, superbe dès le départ, conçue pour les développeurs.
- + - + - +
diff --git a/fr/installation.mdx b/fr/installation.mdx index 83afac895..e8195003b 100644 --- a/fr/installation.mdx +++ b/fr/installation.mdx @@ -3,9 +3,9 @@ title: "Installation de l’interface en ligne de commande (CLI)" description: "Installez la CLI pour prévisualiser et développer votre documentation en local" --- - +Graphique décoratif représentant la CLI. - +Graphique décoratif représentant la CLI.
## Installation de l’interface en ligne de commande (CLI) diff --git a/fr/integrations/analytics/google-analytics.mdx b/fr/integrations/analytics/google-analytics.mdx index a97da5174..a471f3dc4 100644 --- a/fr/integrations/analytics/google-analytics.mdx +++ b/fr/integrations/analytics/google-analytics.mdx @@ -2,11 +2,9 @@ title: "Google Analytics 4" --- -Vous devrez générer une nouvelle propriété GA4 à utiliser avec Mintlify. Les données collectées seront versées dans le même projet que vos autres données Google Analytics. - -Si vous utilisez l’ancienne version de Google Analytics, Universal Analytics, vous pourrez tout de même générer une propriété GA4. Les données GA4 diffèrent légèrement des données UA, mais elles sont quand même collectées dans le même projet. - +Vous devrez générer une nouvelle propriété GA4 à utiliser avec Mintlify. Les données collectées seront ajoutées au même projet que vos autres données Google Analytics. +Si vous utilisez l’ancienne version de Google Analytics, Universal Analytics, vous pourrez tout de même générer une propriété GA4. Les données GA4 diffèrent légèrement des données UA, mais elles sont malgré tout collectées dans le même projet.
## Comment connecter GA4 à Mintlify @@ -16,11 +14,11 @@ Si vous utilisez l’ancienne version de Google Analytics, Universal Analytics, ### Créer un flux Web
-Vous devez créer un flux Web pour obtenir l’ID de mesure à ajouter dans Mintlify. +Vous devez créer un flux Web pour obtenir l’ID de mesure à renseigner dans Mintlify. -Cliquez sur l’icône d’engrenage en bas à gauche de l’écran Google Analytics, puis sur Data Streams. +Cliquez sur l’icône d’engrenage en bas à gauche de l’interface Google Analytics, puis cliquez sur Data Streams. -![](/images/ga4-web-streams.png) +![Capture d’écran de la page Data Streams dans le Dashboard Google Analytics.](/images/ga4-web-streams.png) Créez un flux Web et indiquez l’URL de votre site de documentation Mintlify comme URL du flux. @@ -40,14 +38,17 @@ Ajoutez votre ID de mesure à votre fichier `docs.json` comme suit : } ``` +
### Patientez
Google Analytics met deux à trois jours à afficher vos données. -Vous pouvez utiliser l’extension [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) pour vérifier que Analytics est correctement activé. L’extension consigne un journal dans la console de votre navigateur chaque fois que GA4 effectue une requête. +Vous pouvez utiliser l’extension [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) pour vérifier que Analytics est correctement activé. L’extension consignera un message dans la console de votre navigateur chaque fois que GA4 effectue une requête. - Les liens d’aperçu ont Analytics désactivé. - + +Les liens d’aperçu ont Analytics désactivé. + + \ No newline at end of file diff --git a/fr/organize/navigation.mdx b/fr/organize/navigation.mdx index 24c9bb682..a4ac2ec46 100644 --- a/fr/organize/navigation.mdx +++ b/fr/organize/navigation.mdx @@ -11,13 +11,13 @@ Avec une configuration de navigation appropriée, vous pouvez organiser votre co ## Pages
-Les pages sont l’élément de navigation le plus fondamental. Elles correspondent aux fichiers MDX qui composent votre documentation. +Les pages sont le composant de navigation le plus élémentaire. Elles correspondent aux fichiers MDX qui composent votre documentation. - +Graphique décoratif de pages. - +Graphique décoratif de pages. -Dans l’objet `navigation`, `pages` est un tableau où chaque entrée doit indiquer le chemin d’accès vers un [fichier de page](fr/pages). +Dans l’objet `navigation`, `pages` est un tableau dans lequel chaque entrée doit référencer le chemin d’accès vers un [fichier de page](fr/pages). ```json { @@ -37,13 +37,13 @@ Dans l’objet `navigation`, `pages` est un tableau où chaque entrée doit indi ## Groupes
-Utilisez des groupes pour organiser la navigation de votre barre latérale en sections. Les groupes peuvent être imbriqués, accompagnés de tags et affichés avec des icons. +Utilisez des groupes pour organiser la navigation de votre barre latérale en sections. Les groupes peuvent être imbriqués, accompagnés de tags et stylisés avec des icônes. - +Graphique décoratif représentant des groupes. - +Graphique décoratif représentant des groupes. -Dans l’objet `navigation`, `groups` est un tableau où chaque entrée est un objet qui requiert un champ `group` et un champ `pages`. Les champs `icon`, `tag` et `expanded` sont facultatifs. +Dans l’objet `navigation`, `groups` est un tableau où chaque entrée est un objet qui doit contenir un champ `group` et un champ `pages`. Les champs `icon`, `tag` et `expanded` sont facultatifs. ```json { @@ -97,13 +97,13 @@ Définissez `expanded: true` sur un groupe pour qu’il soit développé par dé ## Tabs
-Les Tabs créent des sections distinctes dans votre documentation avec des chemins d’URL séparés. Elles affichent une barre de navigation horizontale en haut de la documentation, permettant aux utilisateurs de passer d’une section à l’autre. +Les Tabs créent des sections distinctes de votre documentation avec des chemins d’URL séparés. Les Tabs génèrent une barre de navigation horizontale en haut de votre documentation qui permet aux utilisateurs de passer d’une section à l’autre. - +Graphique décoratif d’une navigation par onglets. - +Graphique décoratif d’une navigation par onglets. -Dans l’objet `navigation`, `tabs` est un tableau dont chaque entrée est un objet qui doit contenir un champ `tab` et peut inclure d’autres champs de navigation tels que des groupes, des pages, des icons ou des liens vers des pages externes. +Dans l’objet `navigation`, `tabs` est un tableau où chaque entrée est un objet qui requiert un champ `tab` et peut contenir d’autres champs de navigation tels que des groupes, des pages, des icons ou des liens vers des pages externes. ```json { @@ -191,11 +191,11 @@ Dans l’objet `navigation`, `menu` est un tableau où chaque entrée est un obj Les ancres ajoutent des éléments de navigation persistants en haut de votre barre latérale. Utilisez-les pour structurer votre contenu, offrir un accès rapide à des ressources externes ou créer des appels à l’action bien visibles. - +Illustration décorative d’une navigation par ancres. - +Illustration décorative d’une navigation par ancres. -Dans l’objet `navigation`, `anchors` est un tableau dont chaque entrée est un objet qui doit inclure un champ `anchor` et peut contenir d’autres champs de navigation tels que des groupes, des pages, des icon ou des liens vers des pages externes. +Dans l’objet `navigation`, `anchors` est un tableau où chaque entrée est un objet qui nécessite un champ `anchor` et peut contenir d’autres champs de navigation, tels que des groupes, des pages, des icon, ou des liens vers des pages externes. ```json { @@ -228,9 +228,9 @@ Dans l’objet `navigation`, `anchors` est un tableau dont chaque entrée est un } ``` -Pour les ancres qui pointent uniquement vers des liens externes, utilisez le mot-clé `global`. Les ancres dans un objet `global` doivent comporter un champ `href` et ne peuvent pas cibler un chemin relatif. +Pour les ancres qui renvoient uniquement vers des liens externes, utilisez le mot-clé `global`. Les ancres dans un objet `global` doivent comporter un champ `href` et ne peuvent pas pointer vers un chemin relatif. -Les ancres globales sont particulièrement utiles pour créer des liens vers des ressources qui ne font pas partie de votre documentation, mais qui doivent rester facilement accessibles à vos utilisateurs, comme un blog ou un portail d’assistance. +Les ancres globales sont particulièrement utiles pour créer des liens vers des ressources qui ne font pas partie de votre documentation, mais qui devraient rester facilement accessibles à vos utilisateurs, comme un blog ou un portail d’assistance. ```json { @@ -258,13 +258,13 @@ Les ancres globales sont particulièrement utiles pour créer des liens vers des ## Menus déroulants -Les menus déroulants se trouvent dans un menu extensible en haut de la barre latérale de votre navigation. Chaque élément d’un menu déroulant pointe vers une section de votre documentation. +Les menus déroulants se trouvent dans un menu extensible en haut de la navigation de votre barre latérale. Chaque élément d’un menu déroulant mène à une section de votre documentation. - +Graphique décoratif d’une navigation avec menu déroulant. - +Graphique décoratif d’une navigation avec menu déroulant. -Dans l’objet `navigation`, `dropdowns` est un tableau où chaque entrée est un objet qui requiert un champ `dropdown` et peut contenir d’autres champs de navigation tels que des groupes, des pages, des icon, ou des liens vers des pages externes. +Dans l’objet `navigation`, `dropdowns` est un tableau où chaque entrée est un objet qui requiert un champ `dropdown` et peut contenir d’autres champs de navigation tels que des groups, des pages, des icon ou des liens vers des pages externes. ```json { @@ -301,13 +301,13 @@ Dans l’objet `navigation`, `dropdowns` est un tableau où chaque entrée est u ## Produits - +Graphique décoratif d’un sélecteur de produit. - +Graphique décoratif d’un sélecteur de produit. -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 ensembles de fonctionnalités majeures au sein de votre documentation. +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. -Dans l’objet `navigation`, `products` est un tableau où chaque entrée est un objet qui requiert 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. +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. ```json { @@ -395,11 +395,11 @@ Pour en savoir plus sur la façon de référencer des endpoints OpenAPI dans vot Divisez votre navigation en différentes versions. Les versions peuvent être sélectionnées à partir d’un menu déroulant. - +Illustration décorative d’un sélecteur de version. - +Illustration décorative d’un sélecteur de version. -Dans l’objet `navigation`, `versions` est un tableau où chaque entrée est un objet qui exige un champ `version` et peut contenir n’importe quels autres champs de navigation. +Dans l’objet `navigation`, `versions` est un tableau dans lequel chaque entrée est un objet qui requiert un champ `version` et peut contenir n’importe quels autres champs de navigation. ```json { @@ -409,7 +409,7 @@ Dans l’objet `navigation`, `versions` est un tableau où chaque entrée est un "version": "1.0.0", "groups": [ { - "group": "Prise en main", + "group": "Premiers pas", "pages": ["v1/overview", "v1/quickstart", "v1/development"] } ] @@ -418,7 +418,7 @@ Dans l’objet `navigation`, `versions` est un tableau où chaque entrée est un "version": "2.0.0", "groups": [ { - "group": "Prise en main", + "group": "Premiers pas", "pages": ["v2/overview", "v2/quickstart", "v2/development"] } ] @@ -432,15 +432,15 @@ Dans l’objet `navigation`, `versions` est un tableau où chaque entrée est un ## Langues -Divisez votre navigation par langue. Les langues sont sélectionnables via un menu déroulant. +Divisez votre navigation par langue. Les langues sont sélectionnées depuis un menu déroulant. - +Graphique décoratif d’un sélecteur de langue. - +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 exige un champ `language` et peut contenir tous les autres champs de navigation. +Dans l’objet `navigation`, `languages` est un tableau dont chaque entrée est un objet qui doit inclure un champ `language` et peut contenir n’importe quels autres champs de navigation. -Nous prenons actuellement en charge les langues suivantes pour la localisation : +Nous prenons actuellement en charge les langues suivantes pour la localisation : } horizontal /> @@ -499,7 +499,7 @@ Nous prenons actuellement en charge les langues suivantes pour la localisation } ``` -Pour les traductions automatisées, [contactez notre équipe commerciale](mailto:gtm@mintlify.com) pour discuter de solutions. +Pour des traductions automatisées, [contactez notre équipe commerciale](mailto:gtm@mintlify.com) pour discuter de solutions.
## Imbrication diff --git a/zh/index.mdx b/zh/index.mdx index ac810d2d1..7cce1e096 100644 --- a/zh/index.mdx +++ b/zh/index.mdx @@ -1,6 +1,6 @@ --- title: "简介" -description: "邂逅新一代文档：原生 AI、开箱即用且优雅，专为开发者打造。" +description: "邂逅新一代文档：AI 原生、开箱即用且美观，为开发者打造。" mode: "custom" --- @@ -25,9 +25,9 @@ export const HeroCard = ({ filename, title, description, href }) => {
- + 装饰性背景图像。 - + 装饰性背景图像。
@@ -36,17 +36,17 @@ export const HeroCard = ({ filename, title, description, href }) => {
- 迎接新一代文档：原生 AI、开箱即用且颜值在线，为开发者而生。 + 迎接新一代文档：原生 AI、开箱即用的精美体验，为开发者而生。
- + - + - + - +
diff --git a/zh/installation.mdx b/zh/installation.mdx index 3ce8d7ca3..bead584d0 100644 --- a/zh/installation.mdx +++ b/zh/installation.mdx @@ -1,11 +1,11 @@ --- title: "安装命令行界面（CLI）" -description: "安装命令行界面（CLI），在本地预览并开发文档" +description: "安装命令行界面（CLI），在本地预览并开发你的文档" --- - +用于表示命令行界面（CLI）的装饰性图形。 - +用于表示命令行界面（CLI）的装饰性图形。
## 安装命令行界面（CLI） diff --git a/zh/integrations/analytics/google-analytics.mdx b/zh/integrations/analytics/google-analytics.mdx index ac46e5aa3..07445c5eb 100644 --- a/zh/integrations/analytics/google-analytics.mdx +++ b/zh/integrations/analytics/google-analytics.mdx @@ -2,29 +2,27 @@ title: "Google Analytics 4" --- -您需要创建一个新的GA4 属性以配合 Mintlify 使用。收集的数据将汇入与您其他 Google Analytics 数据相同的项目。 - -如果您仍在使用旧版 Google Analytics（Universal Analytics），依然可以创建GA4 属性。GA4 数据与 UA 数据略有不同，但仍会汇集到同一个项目中。 - +您需要生成一个新的GA4属性以配合 Mintlify 使用。所收集的数据将汇总到与您其他 Google Analytics 数据相同的项目中。 +如果您仍在使用旧版 Google Analytics（Universal Analytics），依然可以生成GA4属性。GA4数据与 UA 数据略有不同，但仍会被归集到同一项目中。
- ## 如何将 GA4 连接到 Mintlify + ## 如何将 GA4 接入 Mintlify
- ### 创建 Web 数据流 + ### 创建 Web 流
-你需要创建一个 Web 数据流以获取 Measurement ID，并将其添加到 Mintlify 中。 +你需要创建一个 Web 流以获取 Measurement ID，并将其填入 Mintlify。 点击 Google Analytics 界面左下角的齿轮图标，然后点击 Data Streams。 -![](/images/ga4-web-streams.png) +![Google Analytics 控制台中 Data Streams 页面截图。](/images/ga4-web-streams.png) -创建一个 Web 数据流，并将你的 Mintlify 文档站点的 URL 填入数据流的 URL。 +创建一个 Web 流，并将你的 Mintlify 文档站点的 URL 作为流的 URL。 -你的 Measurement ID 形如 `G-XXXXXXX`，创建 Web 数据流后会立即显示在 Stream Details 下方。 +你的 Measurement ID 类似于 `G-XXXXXXX`，创建 Web 流后会立即显示在 Stream Details 下方。
### 在 docs.json 中添加 Measurement ID @@ -40,14 +38,17 @@ title: "Google Analytics 4" } ``` +
### 请稍候
-Google Analytics 需要两到三天才会显示你的数据。 +Google Analytics 通常需要两到三天才会显示你的数据。 -你可以使用 [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) 检查是否已正确启用 Analytics。每当 GA4 发出请求时，该扩展都会在浏览器控制台中记录日志。 +你可以使用 [Google Analytics Debugger](https://chrome.google.com/webstore/detail/google-analytics-debugger/jnkmfdileelhofjcijamephohjechhna?hl=en) 检查是否已正确启用 Analytics。每当 GA4 发出请求时，该扩展都会在你的浏览器控制台中记录日志。 - 预览链接已关闭 Analytics。 - + +预览链接的 Analytics 已禁用。 + + \ No newline at end of file diff --git a/zh/organize/navigation.mdx b/zh/organize/navigation.mdx index 382c2c73d..915ede127 100644 --- a/zh/organize/navigation.mdx +++ b/zh/organize/navigation.mdx @@ -11,11 +11,11 @@ description: "构建并自定义文档的导航层级结构" ## 页面
-页面是最基础的导航单元。每个页面对应构成文档的 MDX 文件。 +页面是导航中最基础的组成部分。页面对应构成文档的 MDX 文件。 - +页面的装饰性图形。 - +页面的装饰性图形。 在 `navigation` 对象中，`pages` 是一个数组，其中每个条目都必须引用一个[页面文件](zh/pages)的路径。 @@ -37,13 +37,13 @@ description: "构建并自定义文档的导航层级结构" ## 分组
-使用分组将侧边栏导航组织为不同的部分。分组可以相互嵌套、添加标签，并配合图标进行展示。 +使用分组将侧边栏导航组织成不同部分。分组可以相互嵌套、添加标签，并配合图标进行展示。 - +分组的装饰性图形。 - +分组的装饰性图形。 -在 `navigation` 对象中，`groups` 是一个数组，其中每个条目都是一个对象，且需要包含 `group` 字段和 `pages` 字段。`icon`、`tag` 和 `expanded` 字段为可选。 +在 `navigation` 对象中，`groups` 是一个数组，每个条目都是一个对象，需包含 `group` 字段和 `pages` 字段。`icon`、`tag` 和 `expanded` 字段为可选。 ```json { @@ -97,13 +97,13 @@ description: "构建并自定义文档的导航层级结构" ## 选项卡
-选项卡可为你的文档创建相互独立的部分，并对应各自的 URL 路径。它们会在文档顶部生成一条水平导航栏，方便用户在各部分之间切换。 +选项卡可为你的文档创建彼此独立的 URL 路径分区。它们会在文档顶部生成一条水平导航栏，方便用户在各个部分之间切换。 - +选项卡导航的装饰性图形。 - +选项卡导航的装饰性图形。 -在 `navigation` 对象中，`tabs` 是一个数组，其中每个条目都是一个对象，必须包含 `tab` 字段，并可包含其他导航字段，例如 groups、pages、icon，或指向外部页面的链接。 +在 `navigation` 对象中，`tabs` 是一个数组，其中每个项都是一个对象，必须包含 `tab` 字段，并且还可以包含其他导航字段，例如 groups、pages、icon，或指向外部页面的链接。 ```json { @@ -189,11 +189,11 @@ description: "构建并自定义文档的导航层级结构" ## 锚点 -锚点会在侧边栏顶部添加常驻的导航项。你可以用锚点来为内容分区、提供快速访问外部资源，或创建醒目的号召性操作。 +锚点会在侧边栏顶部添加固定的导航项。你可以用它们来为内容分区、提供快速外链入口，或创建醒目的行动号召。 - +锚点导航的装饰性图形 - +锚点导航的装饰性图形 在 `navigation` 对象中，`anchors` 是一个数组，其中每个条目都是一个对象，必须包含 `anchor` 字段，并且可以包含其他导航字段，例如 groups、pages、icons，或指向外部页面的链接。 @@ -228,9 +228,9 @@ description: "构建并自定义文档的导航层级结构" } ``` -对于仅指向外部链接的锚点，请使用 `global` 关键字。位于 `global` 对象中的锚点必须包含 `href` 字段，且不能指向相对路径。 +对于仅指向外部链接的锚点，请使用 `global` 关键字。`global` 对象中的锚点必须包含 `href` 字段，且不能指向相对路径。 -全局锚点特别适用于链接到不属于你的文档但应便于用户访问的资源，例如博客或支持门户。 +Global 锚点在链接到不属于你文档但应便于用户访问的资源时特别有用，例如博客或支持门户。 ```json { @@ -260,11 +260,11 @@ description: "构建并自定义文档的导航层级结构" 下拉菜单位于侧边栏导航顶部的可展开菜单中。下拉菜单中的每个项都会跳转到文档的某个部分。 - +下拉导航的装饰性图形。 - +下拉导航的装饰性图形。 -在 `navigation` 对象中，`dropdowns` 是一个数组。数组中的每个元素都是一个对象，必须包含 `dropdown` 字段，并且可以包含其他导航字段，例如 groups、pages、icons，或指向外部页面的链接。 +在 `navigation` 对象中，`dropdowns` 是一个数组，其中每个条目都是一个对象，必须包含 `dropdown` 字段，并且可以包含其他导航字段，例如 groups、pages、icons，或指向外部页面的链接。 ```json { @@ -301,13 +301,13 @@ description: "构建并自定义文档的导航层级结构" ## Products - +产品切换器的装饰性图形。 - +产品切换器的装饰性图形。 -Products 会为产品相关文档创建一个独立的导航分区，用于组织产品级文档。使用 Products 可以在文档中区分不同的产品、服务或大型功能集。 +Products 会为组织特定产品文档创建一个独立的导航分区。使用 Products 将不同的产品、服务或重要功能集在文档中加以区分。 -在 `navigation` 对象中，`products` 是一个数组，其中每个条目都是一个对象，必须包含 `product` 字段，并且可以包含其他导航字段，例如 groups、pages、icon，或指向外部页面的链接。 +在 `navigation` 对象中，`products` 是一个数组，每个条目都是一个对象，必须包含 `product` 字段，并且可以包含其他导航字段，例如 groups、pages、icons，或指向外部页面的链接。 ```json { @@ -393,13 +393,13 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 ## 版本 -将导航划分为不同版本。可从下拉菜单中选择版本。 +将导航划分为不同版本。可通过下拉菜单选择版本。 - +版本切换器的装饰性图形 - +版本切换器的装饰性图形 -在 `navigation` 对象中，`versions` 是一个数组，其中每个项都是一个对象，必须包含 `version` 字段，并可包含其他任意导航字段。 +在 `navigation` 对象中，`versions` 是一个数组，每个项都是一个对象，必须包含 `version` 字段，并且可包含任何其他导航相关字段。 ```json { @@ -409,7 +409,7 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 "version": "1.0.0", "groups": [ { - "group": "快速入门", + "group": "开始使用", "pages": ["v1/overview", "v1/quickstart", "v1/development"] } ] @@ -418,7 +418,7 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 "version": "2.0.0", "groups": [ { - "group": "快速入门", + "group": "开始使用", "pages": ["v2/overview", "v2/quickstart", "v2/development"] } ] @@ -432,13 +432,13 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 ## 语言 -将导航按不同语言进行分区。语言可从下拉菜单中选择。 +将导航按不同语言进行分区。语言可通过下拉菜单选择。 - +语言切换器的装饰性图形。 - +语言切换器的装饰性图形。 -在 `navigation` 对象中，`languages` 是一个数组，其中每个项都是一个对象，必须包含 `language` 字段，并且可以包含其他任意导航字段。 +在 `navigation` 对象中，`languages` 是一个数组，每个条目都是一个对象，必须包含 `language` 字段，并且可以包含其他任意导航字段。 我们目前支持以下本地化语言： @@ -480,7 +480,7 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 "language": "en", "groups": [ { - "group": "开始使用", + "group": "快速入门", "pages": ["en/overview", "en/quickstart", "en/development"] } ] @@ -489,7 +489,7 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 "language": "es", "groups": [ { - "group": "开始使用", + "group": "快速入门", "pages": ["es/overview", "es/quickstart", "es/development"] } ] @@ -499,7 +499,7 @@ Products 会为产品相关文档创建一个独立的导航分区，用于组 } ``` -如需自动翻译，请[联系销售团队](mailto:gtm@mintlify.com)讨论解决方案。 +如需使用自动翻译，请[联系销售团队](mailto:gtm@mintlify.com)洽谈解决方案。
## 嵌套