diff --git a/docs.json b/docs.json index 415da2c1e..778defff0 100644 --- a/docs.json +++ b/docs.json @@ -1,19 +1,36 @@ { - "$schema": "https://mintlify.com/docs.json", "theme": "almond", + "$schema": "https://mintlify.com/docs.json", "name": "Mintlify", "colors": { "primary": "#166E3F", "light": "#26BD6C", "dark": "#166E3F" }, + "logo": { + "light": "/logo/light.svg", + "dark": "/logo/dark.svg", + "href": "https://mintlify.com/docs" + }, "favicon": "/favicon.ico", - "icons": { - "library": "lucide" + "api": { + "mdx": { + "auth": { + "method": "bearer" + } + } + }, + "navbar": { + "primary": { + "type": "button", + "label": "Get started", + "href": "https://mintlify.com/start" + } }, "navigation": { "languages": [ { + "language": "en", "tabs": [ { "tab": "Documentation", @@ -310,10 +327,10 @@ } ] } - ], - "language": "en" + ] }, { + "language": "fr", "tabs": [ { "tab": "Documentation", @@ -610,10 +627,10 @@ } ] } - ], - "language": "fr" + ] }, { + "language": "es", "tabs": [ { "tab": "Documentación", @@ -649,7 +666,7 @@ "es/customize/custom-scripts", "es/customize/react-components", { - "group": "Acceso al dashboard", + "group": "Acceso al panel", "pages": [ "es/dashboard/sso", "es/dashboard/permissions", @@ -724,7 +741,7 @@ ] }, { - "group": "Implementar", + "group": "Desplegar", "icon": "boxes", "pages": [ "es/deploy/deployments", @@ -752,7 +769,7 @@ "icon": "wrench", "pages": [ { - "group": "IA", + "group": "AI", "pages": [ "es/ai/assistant", "es/ai/agent", @@ -763,7 +780,7 @@ ] }, { - "group": "Analytics", + "group": "Analíticas", "pages": [ "es/analytics/overview", "es/analytics/feedback", @@ -776,7 +793,7 @@ "group": "Integraciones", "pages": [ { - "group": "Analytics", + "group": "Analíticas", "pages": [ "es/integrations/analytics/overview", "es/integrations/analytics/amplitude", @@ -797,7 +814,7 @@ ] }, { - "group": "SDK", + "group": "SDKs", "pages": [ "es/integrations/sdks/speakeasy", "es/integrations/sdks/stainless" @@ -828,7 +845,7 @@ "tab": "Guías", "groups": [ { - "group": "IA", + "group": "AI", "icon": "bot", "pages": [ "es/guides/geo", @@ -838,14 +855,14 @@ ] }, { - "group": "Documentación de la API", + "group": "Documentación de API", "icon": "file-json", "pages": [ "es/guides/migrating-from-mdx" ] }, { - "group": "Analytics", + "group": "Analíticas", "icon": "chart-line", "pages": [ "es/guides/improving-docs" @@ -862,17 +879,17 @@ ] }, { - "tab": "Referencia de la API", + "tab": "Referencia de API", "groups": [ { - "group": "Referencia de la API", + "group": "Referencia de API", "icon": "file-json", "pages": [ "es/api/introduction" ] }, { - "group": "Administrador", + "group": "Admin", "icon": "activity", "pages": [ "es/api/update/trigger", @@ -880,7 +897,7 @@ ] }, { - "group": "Agente", + "group": "Agent", "icon": "pen-line", "pages": [ "es/api/agent/create-agent-job", @@ -889,7 +906,7 @@ ] }, { - "group": "assistant", + "group": "Assistant", "icon": "bot-message-square", "pages": [ "es/api/assistant/create-assistant-message", @@ -899,10 +916,10 @@ ] }, { - "tab": "Cambios", + "tab": "Changelog", "groups": [ { - "group": "Cambios", + "group": "Changelog", "icon": "calendar", "pages": [ "es/changelog" @@ -910,10 +927,10 @@ } ] } - ], - "language": "es" + ] }, { + "language": "zh", "tabs": [ { "tab": "文档", @@ -1210,30 +1227,10 @@ } ] } - ], - "language": "zh" + ] } ] }, - "logo": { - "light": "/logo/light.svg", - "dark": "/logo/dark.svg", - "href": "https://mintlify.com/docs" - }, - "api": { - "mdx": { - "auth": { - "method": "bearer" - } - } - }, - "navbar": { - "primary": { - "type": "button", - "label": "Get started", - "href": "https://mintlify.com/start" - } - }, "footer": { "socials": { "x": "https://x.com/mintlify", @@ -1315,17 +1312,8 @@ } ] }, - "thumbnails": { - "background": "/images/thumbnail/background.svg" - }, - "contextual": { - "options": [ - "copy", - "chatgpt", - "claude", - "cursor", - "vscode" - ] + "icons": { + "library": "lucide" }, "redirects": [ { @@ -1688,5 +1676,17 @@ "koala": { "publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8" } + }, + "contextual": { + "options": [ + "copy", + "chatgpt", + "claude", + "cursor", + "vscode" + ] + }, + "thumbnails": { + "background": "/images/thumbnail/background.svg" } } \ No newline at end of file diff --git a/es/organize/navigation.mdx b/es/organize/navigation.mdx index a81f9185a..b45e7f61d 100644 --- a/es/organize/navigation.mdx +++ b/es/organize/navigation.mdx @@ -1,23 +1,21 @@ --- -title: "Navegación" -description: "Estructura y personaliza la jerarquía de navegación de tu documentación" +- title: Navegación +- description: Estructura y personaliza la jerarquía de navegación de tu documentación --- -La propiedad [navigation](es/settings#param-navigation) en `docs.json` controla la estructura y la jerarquía de la información de tu documentación. +El [navigation](settings#param-navigation) property en `docs.json` controla la estructura y jerarquía de información de tu documentación. -Con una configuración de navegación adecuada, puedes organizar tu contenido para que los usuarios encuentren exactamente lo que buscan. +Con una configuración de navegación adecuada, puedes organizar tu contenido para que los usuarios puedan encontrar exactamente lo que están buscando. -
- ## Páginas -
+## Pages -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. +Las Pages son el componente de navegación más fundamental. Las Pages se mapean a los archivos MDX que componen tu documentación. -Gráfico decorativo de páginas. +Decorative graphic of pages. -Gráfico decorativo de páginas. +Decorative graphic of 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). +En el `navigation` object, `pages` es un array donde cada entrada debe hacer referencia a la ruta de un [page file](pages). ```json { @@ -33,30 +31,28 @@ En el objeto `navigation`, `pages` es un array donde cada entrada debe hacer ref } ``` -
- ## Grupos -
+## Groups -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. +Usa groups para organizar la navegación de tu barra lateral en secciones. Los groups pueden anidarse entre sí, etiquetarse con tags y estilizarse con iconos. -Gráfico decorativo de grupos. +Decorative graphic of groups. -Gráfico decorativo de grupos. +Decorative graphic of groups. -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. +En el `navigation` object, `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. ```json { "navigation": { "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "icon": "play", "expanded": false, "pages": [ "quickstart", { - "group": "Edición", + "group": "Editing", "icon": "pencil", "pages": [ "installation", @@ -66,9 +62,9 @@ En el objeto `navigation`, `groups` es un arreglo en el que cada entrada es un o ] }, { - "group": "Escribiendo contenido", + "group": "Writing content", "icon": "notebook-text", - "tag": "NUEVO", + "tag": "NEW", "pages": [ "writing-content/page", "writing-content/text" @@ -79,38 +75,34 @@ En el objeto `navigation`, `groups` es un arreglo en el que cada entrada es un o } ``` -
- ### Estado expandido por defecto -
+### Default expanded state -Establece `expanded: true` en un grupo para que se muestre expandido por defecto en la barra lateral de navigation. Esto es útil para resaltar secciones importantes o mejorar el descubrimiento del contenido clave. +Establece `expanded: true` en un grupo para que se expanda por defecto en la barra lateral de navegación. Esto es útil para destacar secciones importantes o mejorar la visibilidad del contenido clave. ```json { - "group": "Comenzar", + "group": "Getting started", "expanded": true, "pages": ["quickstart", "installation"] } ``` -
- ## Tabs -
+## Tabs -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. +Los Tabs crean secciones distintas de tu documentación con rutas URL separadas. Los Tabs crean 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. +Decorative graphic of a tab navigation. -Gráfico decorativo de una navegación por pestañas. +Decorative graphic of a tab navigation. -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. +En el `navigation` object, `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, icons, o enlaces a páginas externas. ```json { "navigation": { "tabs": [ { - "tab": "Referencia de API", + "tab": "API reference", "icon": "square-terminal", "pages": [ "api-reference/get", @@ -119,7 +111,7 @@ En el objeto `navigation`, `tabs` es un array donde cada entrada es un objeto qu ] }, { - "tab": "SDK", + "tab": "SDKs", "icon": "code", "pages": [ "sdk/fetch", @@ -137,28 +129,26 @@ En el objeto `navigation`, `tabs` es un array donde cada entrada es un objeto qu } ``` - +### Menus -Los menús añaden elementos de navegación desplegables a una Tab. Usa los menús para ayudar a los usuarios a ir directamente a páginas específicas dentro de una Tab. +Los Menus añaden elementos de navegación desplegables a una pestaña. Usa menus para ayudar a los usuarios a ir directamente a páginas específicas dentro de una pestaña. -En el objeto `navigation`, `menu` es un array donde cada entrada es un objeto que requiere un campo `item` y puede incluir otros campos de navegación como groups, pages, icon o enlaces a páginas externas. +En el `navigation` object, `menu` es un array donde cada entrada es un objeto que requiere un campo `item` y puede contener otros campos de navegación como groups, pages, icons, o enlaces a páginas externas. ```json { "navigation": { "tabs": [ { - "tab": "Herramientas para desarrolladores", + "tab": "Developer tools", "icon": "square-terminal", "menu": [ { - "item": "Referencia de API", + "item": "API reference", "icon": "rocket", "groups": [ { - "group": "Endpoints principales", + "group": "Core endpoints", "icon": "square-terminal", "pages": [ "api-reference/get", @@ -169,9 +159,9 @@ En el objeto `navigation`, `menu` es un array donde cada entrada es un objeto qu ] }, { - "item": "SDK", + "item": "SDKs", "icon": "code", - "description": "Los SDK se utilizan para interactuar con la API.", + "description": "SDKs are used to interact with the API.", "pages": [ "sdk/fetch", "sdk/create", @@ -185,24 +175,22 @@ En el objeto `navigation`, `menu` es un array donde cada entrada es un objeto qu } ``` -
- ## Anclas -
+## Anchors -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 llamadas a la acción destacadas. +Los Anchors añaden elementos de navegación persistentes en la parte superior de tu barra lateral. Usa anchors para seccionar tu contenido, proporcionar acceso rápido a recursos externos o crear llamadas a la acción destacadas. -Gráfico decorativo de una navegación con anclas. +Decorative graphic of an anchor navigation. -Gráfico decorativo de una navegación con anclas. +Decorative graphic of an anchor navigation. -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 `navigation` object, `anchors` es un array 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. ```json { "navigation": { "anchors": [ { - "anchor": "Documentación", + "anchor": "Documentation", "icon": "book-open", "pages": [ "quickstart", @@ -211,7 +199,7 @@ En el objeto `navigation`, `anchors` es un arreglo donde cada entrada es un obje ] }, { - "anchor": "Referencia de la API", + "anchor": "API reference", "icon": "square-terminal", "pages": [ "api-reference/get", @@ -228,9 +216,9 @@ En el objeto `navigation`, `anchors` es un arreglo donde cada entrada es un obje } ``` -Para los anclajes que apuntan únicamente 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. +Para anchors que dirigen solo a enlaces externos, usa la palabra clave `global`. Los anchors en un objeto `global` deben tener un campo `href` y no pueden apuntar a una ruta relativa. -Los anclajes globales son especialmente útiles para vincular 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. +Los anchors globales son particularmente útiles para enlazar a recursos que no forman parte de tu documentación, pero deberían ser fácilmente accesibles para tus usuarios, como un blog o un portal de soporte. ```json { @@ -238,7 +226,7 @@ Los anclajes globales son especialmente útiles para vincular recursos que no fo "global": { "anchors": [ { - "anchor": "Comunidad", + "anchor": "Community", "icon": "house", "href": "https://slack.com" }, @@ -254,24 +242,22 @@ Los anclajes globales son especialmente útiles para vincular recursos que no fo } ``` - +## Dropdowns -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. +Los Dropdowns están contenidos en un menú expandible en la parte superior de tu navegación lateral. Cada elemento en un dropdown dirige a una sección de tu documentación. -Gráfico decorativo de una navigation con menú desplegable. +Decorative graphic of a dropdown navigation. -Gráfico decorativo de una navigation con menú desplegable. +Decorative graphic of a dropdown navigation. -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. +En el `navigation` object, `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 { "navigation": { "dropdowns": [ { - "dropdown": "Documentación", + "dropdown": "Documentation", "icon": "book-open", "pages": [ "quickstart", @@ -280,7 +266,7 @@ En el objeto `navigation`, `dropdowns` es un array donde cada entrada es un obje ] }, { - "dropdown": "Referencia de API", + "dropdown": "API reference", "icon": "square-terminal", "pages": [ "api-reference/get", @@ -297,17 +283,15 @@ En el objeto `navigation`, `dropdowns` es un array donde cada entrada es un obje } ``` -
- ## Productos -
+## Products -Gráfico decorativo de un selector de productos. +Decorative graphic of a product switcher. -Gráfico decorativo de un selector de productos. +Decorative graphic of a product switcher. -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. +Los Products crean una división de navegación dedicada para organizar documentación específica de productos. Usa products para separar diferentes ofertas, servicios o conjuntos de características principales dentro de tu documentación. -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. +En el `navigation` object, `products` es un array 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 { @@ -315,11 +299,11 @@ En el objeto `navigation`, `products` es un arreglo donde cada entrada es un obj "products": [ { "product": "Core API", - "description": "Descripción de la API principal", + "description": "Core API description", "icon": "api", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": [ "core-api/quickstart", "core-api/authentication" @@ -335,8 +319,8 @@ En el objeto `navigation`, `products` es un arreglo donde cada entrada es un obj ] }, { - "product": "Plataforma de Analytics", - "description": "Descripción de la Plataforma de Analytics", + "product": "Analytics Platform", + "description": "Analytics Platform description", "icon": "chart-bar", "pages": [ "analytics/overview", @@ -345,8 +329,8 @@ En el objeto `navigation`, `products` es un arreglo donde cada entrada es un obj ] }, { - "product": "SDK móvil", - "description": "Descripción del SDK móvil", + "product": "Mobile SDK", + "description": "Mobile SDK description", "icon": "smartphone", "href": "https://mobile-sdk-docs.example.com" } @@ -355,20 +339,18 @@ En el objeto `navigation`, `products` es un arreglo donde cada entrada es un obj } ``` -
- ## OpenAPI -
+## OpenAPI -Integra especificaciones de OpenAPI directamente en tu estructura de navegación para generar automáticamente la documentación de tu API. Crea secciones de API dedicadas o coloca páginas de endpoints dentro de otros componentes de la navegación. +Integra especificaciones OpenAPI directamente en tu estructura de navegación para generar automáticamente documentación de API. Crea secciones de API dedicadas o coloca páginas de endpoints dentro de otros componentes de navegación. -Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu jerarquía de navegación. Los elementos descendientes heredarán esta especificación a menos que definan la suya propia. +Establece una especificación OpenAPI predeterminada en cualquier nivel de tu jerarquía de navegación. Los elementos secundarios heredarán esta especificación a menos que definan su propia especificación. ```json { "navigation": { "groups": [ { - "group": "Referencia de API", + "group": "API reference", "openapi": "/path/to/openapi-v1.json", "pages": [ "overview", @@ -376,7 +358,7 @@ Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu "GET /users", "POST /users", { - "group": "Productos", + "group": "Products", "openapi": "/path/to/openapi-v2.json", "pages": [ "GET /products", @@ -390,19 +372,17 @@ Configura una especificación de OpenAPI predeterminada en cualquier nivel de tu } ``` -Para obtener más información sobre cómo hacer referencia a endpoints de OpenAPI en tu documentación, consulta la [configuración de OpenAPI](/es/api-playground/openapi-setup). +Para más información sobre cómo referenciar endpoints OpenAPI en tus documentos, consulta la [OpenAPI setup](/es/api-playground/openapi-setup). -
- ## Versiones -
+## Versions -Divide tu navigation en diferentes versiones. Puedes seleccionar la versión desde un menú desplegable. +Divide tu navegación en diferentes versiones. Las versiones se pueden seleccionar desde un menú desplegable. -Gráfico decorativo de un selector de versión. +Decorative graphic of a version switcher. -Gráfico decorativo de un selector de versión. +Decorative graphic of a version switcher. -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. +En el `navigation` object, `versions` es un array donde cada entrada es un objeto que requiere un campo `version` y puede contener cualquier otro campo de navegación. ```json { @@ -412,7 +392,7 @@ En el objeto `navigation`, `versions` es un array en el que cada entrada es un o "version": "1.0.0", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": ["v1/overview", "v1/quickstart", "v1/development"] } ] @@ -421,7 +401,7 @@ En el objeto `navigation`, `versions` es un array en el que cada entrada es un o "version": "2.0.0", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": ["v2/overview", "v2/quickstart", "v2/development"] } ] @@ -431,17 +411,15 @@ En el objeto `navigation`, `versions` es un array en el que cada entrada es un o } ``` -
- ## Idiomas -
+## Languages -Divide tu navigation en varios idiomas. Los idiomas se pueden seleccionar desde un menú desplegable. +Divide tu navegación en diferentes idiomas. Los idiomas se pueden seleccionar desde un menú desplegable. -Gráfico decorativo de un selector de idioma. +Decorative graphic of a language switcher. -Gráfico decorativo de un selector de idioma. +Decorative graphic of a language switcher. -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. +En el `navigation` object, `languages` es un array donde cada entrada es un objeto que requiere un campo `language` y puede contener cualquier otro campo de navegación. Actualmente admitimos los siguientes idiomas para la localización: @@ -483,7 +461,7 @@ Actualmente admitimos los siguientes idiomas para la localización: "language": "en", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": ["en/overview", "en/quickstart", "en/development"] } ] @@ -492,7 +470,7 @@ Actualmente admitimos los siguientes idiomas para la localización: "language": "es", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": ["es/overview", "es/quickstart", "es/development"] } ] @@ -502,16 +480,14 @@ Actualmente admitimos los siguientes idiomas para la localización: } ``` -Para traducciones automatizadas, [ponte en contacto con nuestro equipo de ventas](mailto:gtm@mintlify.com) para analizar soluciones. +Para traducciones automatizadas, [contact our sales team](mailto:gtm@mintlify.com) para discutir soluciones. -
- ## Anidación -
+## Nesting -Puedes usar cualquier combinación de anclas, pestañas, menús desplegables y productos. Los componentes se pueden anidar entre sí de forma intercambiable para crear la estructura de navigation que desees. +Puedes usar cualquier combinación de anchors, tabs, dropdowns y products. Los componentes pueden anidarse entre sí de manera intercambiable para crear la estructura de navegación deseada. - ```json Anclas + ```json Anchors { "navigation": { "anchors": [ @@ -581,7 +557,7 @@ Puedes usar cualquier combinación de anclas, pestañas, menús desplegables y p } ``` - ```json Tabs con ancla externa + ```json Tabs with external anchor { "navigation": { "global": { @@ -625,52 +601,46 @@ Puedes usar cualquier combinación de anclas, pestañas, menús desplegables y p ``` - +## Breadcrumbs -Las migas de pan muestran la ruta completa de navegación en la parte superior de las páginas. Algunos temas las traen habilitadas de forma predeterminada y otros no. Puedes controlar si las migas de pan están habilitadas en tu sitio usando la propiedad `styling` en tu `docs.json`. +Los Breadcrumbs muestran la ruta de navegación completa en la parte superior de las páginas. Algunos temas tienen breadcrumbs habilitados por defecto y otros no. Puedes controlar si los breadcrumbs están habilitados para tu sitio usando la propiedad `styling` en tu `docs.json`. - ```json Mostrar migas de pan completas + ```json Display full breadcrumbs "styling": { "eyebrows": "breadcrumbs" } ``` - ```json Mostrar solo la sección superior + ```json Display parent section only "styling": { "eyebrows": "section" } ``` -
- ## Configuración de la interacción -
+## Configuración de interacción -Controla cómo los usuarios interactúan con los elementos de navigation usando la propiedad `interaction` en tu `docs.json`. +Controla cómo los usuarios interactúan con los elementos de navegación usando la propiedad `interaction` en tu `docs.json`. -
- ### Habilitar la navegación automática para grupos -
+### Habilitar auto-navegación para grupos -Cuando un usuario expande un grupo de navigation, algunos temas navegarán automáticamente a la primera página del grupo. Puedes anular el comportamiento predeterminado del tema usando la opción `drilldown`. +Cuando un usuario expande un grupo de navegación, algunos temas navegarán automáticamente a la primera página del grupo. Puedes anular el comportamiento predeterminado de un tema usando la opción `drilldown`. -* Configúralo en `true` para forzar la navegación automática a la primera página cuando se selecciona un grupo de navigation. -* Configúralo en `false` para evitar la navegación y solo expandir o contraer el grupo al seleccionarlo. -* Déjalo sin configurar para usar el comportamiento predeterminado del tema. +* Establece en `true` para forzar la navegación automática a la primera página cuando se selecciona un grupo de navegación. +* Establece en `false` para prevenir la navegación y solo expandir o colapsar el grupo cuando es seleccionado. +* Dejar sin configurar para usar el comportamiento predeterminado del tema. ```json Force navigation "interaction": { - "drilldown": true // Forzar la navegación a la primera página cuando un usuario expande un menú desplegable + "drilldown": true // Force navigation to first page when a user expands a dropdown } ``` ```json Prevent navigation "interaction": { - "drilldown": false // No navegar nunca, solo expandir o contraer el grupo + "drilldown": false // Never navigate, only expand or collapse the group } ``` - \ No newline at end of file + diff --git a/es/organize/settings.mdx b/es/organize/settings.mdx index 1914b2b43..d9dd90627 100644 --- a/es/organize/settings.mdx +++ b/es/organize/settings.mdx @@ -1,54 +1,47 @@ --- -title: "Configuración global" -description: "Configura la configuración del sitio con el archivo `docs.json`" -keywords: ["docs.json", "configuración", "personalización", "ajustes"] +- title: Configuraciones globales +- description: Configura ajustes para todo el sitio con el archivo `docs.json` --- -import IconsOptional from "/snippets/es/icons-optional.mdx"; +import IconsOptional from "/snippets/icons-optional.mdx"; -El archivo `docs.json` te permite convertir una colección de archivos Markdown en un sitio de documentación navegable y personalizado. Este archivo de configuración obligatorio controla el estilo, la navigation, las integrations y más. Piénsalo como el plano de tu documentación. +The `docs.json` file lets you turn a collection of Markdown files into a navigable, customized documentation site. This required configuration file controls styling, navigation, integrations, and more. Think of it as the blueprint for your documentation. -La configuración en `docs.json` se aplica globalmente a todas las páginas. +Settings in `docs.json` apply globally to all pages. -
- ## Configurar tu `docs.json` -
+## Setting up your `docs.json` -Para empezar, solo necesitas especificar `theme`, `name`, `colors.primary` y `navigation`. Los demás campos son opcionales y puedes añadirlos a medida que crezcan las necesidades de tu documentación. +To get started, you only need to specify `theme`, `name`, `colors.primary`, and `navigation`. Other fields are optional and you can add them as your documentation needs grow. -Para obtener la mejor experiencia de edición, incluye la referencia del esquema en la parte superior de tu archivo `docs.json`. Esto habilita el autocompletado, la validación y sugerencias útiles en la mayoría de los editores de código: +For the best editing experience, include the schema reference at the top of your `docs.json` file. This enables autocomplete, validation, and helpful tooltips in most code editors: ```json { "$schema": "https://mintlify.com/docs.json", "theme": "mint", - "name": "Tu Documentación", + "name": "Your Docs", "colors": { "primary": "#ff0000" }, "navigation": { - // Tu estructura de navegación + // Your navigation structure } - // El resto de tu configuración + // The rest of your configuration } ``` -
- ## Referencia -
+## Referencia -Esta sección contiene la referencia completa del archivo `docs.json`. +This section contains the full reference for the `docs.json` file. -
- ### Personalización -
+### Personalización El tema de diseño de tu sitio. - Una de las siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`. + Uno de los siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`, `aspen`. - Consulta [Temas](es/themes) para obtener más información. + Ver [Temas](themes) para más información. @@ -56,23 +49,23 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Los colores que usa 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 utilizados en tu documentación. Los colores se aplican de manera diferente según los temas. Si solo proporcionas un color primario, se utilizará para todos los elementos de color. - + - El color principal de tu documentación. Generalmente se usa para resaltar en modo claro, con algunas variaciones según el tema. + El color primario para tu documentación. Generalmente se usa para énfasis en modo claro, con algunas variaciones según el tema. Debe ser un código hexadecimal que comience con `#`. - El color utilizado para resaltar en modo oscuro. + El color utilizado para énfasis en modo oscuro. Debe ser un código hexadecimal que comience con `#`. - El color utilizado para botones y estados hover en modo claro y oscuro, con algunas variaciones según el tema. + El color utilizado para botones y estados de hover en ambos modos claro y oscuro, con algunas variaciones según el tema. Debe ser un código hexadecimal que comience con `#`. @@ -84,34 +77,33 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Tu logotipo para los modos claro y oscuro. + Tu logo para ambos modos claro y oscuro. - Ruta al archivo de tu logotipo para el modo claro. Incluye la extensión del archivo. Ejemplo: `/logo.png` + Ruta que apunta a tu archivo de logo para modo claro. Incluye la extensión del archivo. Ejemplo: `/logo.png` - Ruta al archivo de tu logotipo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/logo-dark.png` + Ruta que apunta a tu archivo de logo para modo oscuro. Incluye la extensión del archivo. Ejemplo: `/logo-dark.png` - 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` + La URL a la que redirigir al hacer clic en el logo. Si no se proporciona, el logo 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 adecuados. - Puede ser un único archivo o archivos separados para los modos claro y oscuro. Ejemplo: `/favicon.png` + Ruta a tu archivo de favicon, incluyendo la extensión del archivo. Se redimensiona automáticamente a tamaños apropiados de favicon. Puede ser un solo archivo o archivos separados para modo claro y oscuro. Ejemplo: `/favicon.png` - Ruta a tu archivo de favicon para el modo claro. Incluye la extensión del archivo. Ejemplo: `/favicon.png` + Ruta a tu archivo de favicon para modo claro. Incluye la extensión del archivo. Ejemplo: `/favicon.png` - Ruta a tu archivo de favicon para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/favicon-dark.png` + Ruta a tu archivo de favicon para modo oscuro. Incluye la extensión del archivo. Ejemplo: `/favicon-dark.png` @@ -119,13 +111,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Personalización de miniaturas para redes sociales y vistas previas de páginas. - + - El tema visual de tus miniaturas. Si no se especifica, las miniaturas usan el esquema de color de tu sitio definido en el campo `colors`. + El tema visual de tus miniaturas. Si no se especifica, las miniaturas utilizan el esquema de colores de tu sitio definido por el campo `colors`. - Imagen de fondo para tus miniaturas. Puede ser una ruta relativa o una URL absoluta. + Imagen de fondo para tus miniaturas. Puede ser una ruta relativa o URL absoluta. @@ -133,26 +125,26 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Configuraciones de estilo visual. - + - El estilo del “eyebrow” de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta completa de navegación. De forma predeterminada es `section`. + El estilo del encabezado de la página. Elige `section` para mostrar el nombre de la sección o `breadcrumbs` para mostrar la ruta de navegación completa. Por defecto es `section`. - Configuración del tema de los bloques de código. De forma predeterminada es `"system"`. + Configuración del tema de bloques de código. Por defecto es `"system"`. **Configuración simple:** * `"system"`: Coincidir con el modo actual del sitio (claro u oscuro) * `"dark"`: Usar siempre el modo oscuro - **Configuración de tema personalizada:** + **Configuración de tema personalizado:** - * Usa una cadena para especificar un único [tema de Shiki](https://shiki.style/themes) para todos los bloques de código - * Usa un objeto para especificar [temas de Shiki](https://shiki.style/themes) separados para los modos claro y oscuro + * Usa una cadena para especificar un solo tema [Shiki theme](https://shiki.style/themes) para todos los bloques de código + * Usa un objeto para especificar temas [Shiki themes](https://shiki.style/themes) separados para modos claro y oscuro - Un único nombre de tema de Shiki para usar tanto en modo claro como oscuro. + Un solo nombre de tema Shiki para usar tanto en modo claro como oscuro. ```json "styling": { @@ -164,15 +156,15 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Temas separados para los modos claro y oscuro. + Temas separados para modos claro y oscuro. - Un nombre de tema de Shiki para el modo claro. + Un nombre de tema Shiki para modo claro. - Un nombre de tema de Shiki para el modo oscuro. + Un nombre de tema Shiki para modo oscuro. ```json @@ -192,79 +184,79 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Configuración de la biblioteca de iconos. + Configuración de biblioteca de iconos. - + - Biblioteca de iconos para usar en toda tu documentación. De forma predeterminada es `fontawesome`. + Biblioteca de iconos para usar en toda tu documentación. Por defecto es `fontawesome`. - 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. + Puedes especificar una URL a un icono alojado externamente, 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. - Configuración tipográfica para tu documentación. La fuente predeterminada es [Inter](https://fonts.google.com/specimen/Inter). + 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". + Familia de fuente, como "Open Sans". - Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Peso de fuente, como 400 o 700. Las fuentes variables admiten pesos precisos como 550. - URL del archivo de tu 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 fuente. + URL a tu fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](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 Google Font `family`, por lo que no se necesita URL de origen. - Formato del archivo de fuente. + Formato de archivo de fuente. - Sobrescribe la configuración de la fuente específicamente para los encabezados. + Anular la configuración de fuente específicamente para encabezados. - Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display". + Familia de fuente, como "Open Sans", "Playfair Display". - Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Peso de fuente, como 400, 700. Las fuentes variables admiten pesos precisos como 550. - URL del archivo de tu 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 fuente. + URL a tu fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](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 Google Font `family`, por lo que no se necesita URL de origen. - Formato del archivo de fuente. + Formato de archivo de fuente. - Sobrescribe la configuración de la fuente específicamente para el cuerpo del texto. + Anular la configuración de fuente específicamente para el texto del cuerpo. - Familia tipográfica, por ejemplo, "Open Sans", "Playfair Display". + Familia de fuente, como "Open Sans", "Playfair Display". - Peso tipográfico, como 400 o 700. Las fuentes variables admiten pesos precisos como 550. + Peso de fuente, como 400, 700. Las fuentes variables admiten pesos precisos como 550. - URL del archivo de tu 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 fuente. + URL a tu fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](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 Google Font `family`, por lo que no se necesita URL de origen. - Formato del archivo de fuente. + Formato de archivo de fuente. @@ -272,33 +264,33 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Configuración del conmutador de modo claro/oscuro. + Configuración del interruptor de modo claro/oscuro. - Modo de tema predeterminado. Elige `system` para ajustarlo a la configuración del sistema operativo del usuario, o `light` o `dark` para forzar un modo específico. De manera predeterminada es `system`. + Modo de tema predeterminado. Elige `system` para coincidir con la configuración del sistema operativo de los usuarios, o `light` o `dark` para forzar un modo específico. Por defecto es `system`. - Indica si se debe ocultar el conmutador de modo claro/oscuro. De manera predeterminada es `true`. + Si se debe ocultar el interruptor de modo claro/oscuro. Por defecto es `true`. - Configuración del color y la decoración del fondo. + Configuración de color de fondo y decoración. - + - Imagen de fondo para tu sitio. Puede ser un único archivo o archivos separados para los modos light y dark. + Imagen de fondo para tu sitio. Puede ser un solo archivo o archivos separados para modo claro y oscuro. - Ruta de la imagen de fondo para el modo light. Incluye la extensión del archivo. Ejemplo: `/background.png`. + Ruta a tu imagen de fondo para el modo claro. Incluye la extensión del archivo. Ejemplo: `/background.png`. - Ruta de la imagen de fondo para el modo dark. Incluye la extensión del archivo. Ejemplo: `/background-dark.png`. + Ruta a tu imagen de fondo para el modo oscuro. Incluye la extensión del archivo. Ejemplo: `/background-dark.png`. @@ -308,17 +300,17 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Colores de fondo personalizados para los modos light y dark. + Colores de fondo personalizados para modos claro y oscuro. - Color de fondo para el modo light. + Color de fondo para el modo claro. Debe ser un código hexadecimal que comience con `#`. - Color de fondo para el modo dark. + Color de fondo para el modo oscuro. Debe ser un código hexadecimal que comience con `#`. @@ -327,20 +319,18 @@ Esta sección contiene la referencia completa del archivo `docs.json`. -
- ### Estructura -
+### Structure - Elementos de la barra de navegación que apuntan a enlaces externos. + Elementos de la barra de navegación para enlaces externos. - Enlaces que se mostrarán en la barra de navegación. + Enlaces para mostrar en la barra de navegación - + - Texto del enlace. + Texto para el enlace. @@ -352,19 +342,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Botón principal de la barra de navegación. + Botón principal en la barra de navegación. - + - Estilo del botón. Elige `button` para un botón estándar con label o `github` para un enlace a un repositorio de GitHub con icon. + Estilo del botón. Elige `button` para un botón estándar con una etiqueta o `github` para un enlace a un repositorio de GitHub con icono. - Texto del botón. Solo aplica cuando `type` es `button`. + Texto del botón. Solo se aplica cuando `type` es `button`. - Destino del botón. Debe ser una URL externa. Si `type` es `github`, debe ser la URL de un repositorio de GitHub. + Destino del botón. Debe ser una URL externa. Si `type` es `github`, debe ser una URL de repositorio de GitHub. @@ -374,13 +364,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. La estructura de navegación de tu contenido. - + - Elementos de navegación globales que aparecen en todas las páginas y secciones. + Elementos de navegación global que aparecen en todas las páginas y secciones. - - Configuración del selector de idioma para sitios localizados. + + Configuración del selector de idiomas para sitios localizados. @@ -388,35 +378,35 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Indica si es el idioma predeterminado. + Si este es el idioma predeterminado. - Indica si se debe ocultar esta opción de idioma de forma predeterminada. + Si ocultar esta opción de idioma por defecto. - Una ruta válida o un enlace externo a la versión de tu documentación en este idioma. + Una ruta válida o enlace externo a esta versión en el idioma de tu documentación. - + Configuración del selector de versiones para sitios con múltiples versiones. - Nombre visible de la versión. + Nombre de visualización de la versión. Longitud mínima: 1 - Indica si esta es la versión predeterminada. + Si esta es la versión predeterminada. - Indica si se debe ocultar esta opción de versión por defecto. + Si ocultar esta opción de versión por defecto. @@ -425,12 +415,12 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - + Pestañas de navegación de nivel superior para organizar secciones principales. - Nombre visible de la Tab. + Nombre de visualización de la pestaña. Longitud mínima: 1 @@ -438,21 +428,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Indica si esta Tab se oculta de forma predeterminada. + Si ocultar esta pestaña por defecto. - URL o ruta al destino de la Tab. + URL o ruta para el destino de la pestaña. - - Enlaces ancla que aparecen de forma destacada en la navigation de la barra lateral. + + Enlaces anclados que aparecen de forma destacada en la navegación de la barra lateral. - Nombre para mostrar del ancla. + Nombre de visualización del ancla. Longitud mínima: 1 @@ -478,21 +468,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Indica si se debe ocultar este ancla de forma predeterminada. + Si ocultar esta ancla por defecto. - URL o ruta de destino del ancla. + URL o ruta para el destino del ancla. - + Menús desplegables para organizar contenido relacionado. - + - Nombre visible del menú desplegable. + Nombre de visualización del desplegable. Longitud mínima: 1 @@ -500,21 +490,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Indica si este menú desplegable se oculta de forma predeterminada. + Si ocultar este desplegable por defecto. - URL o ruta de destino del menú desplegable. + URL o ruta para el destino del desplegable. - - Productos para organizar el contenido en secciones. + + Productos para organizar contenido en secciones. - Nombre visible del producto. + Nombre de visualización del producto. @@ -527,46 +517,46 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - - Selector de idiomas para sitios [multilingües](es/navigation#languages). + + Selector de idioma para [multi-language](navigation#languages) sitios. - - Selector de versión para sitios con varias [versiones](es/navigation#versions). + + Selector de versiones para sitios con múltiples [versions](navigation#versions). - - Pestañas de navegación de nivel superior [tabs](es/navigation#tabs). + + Navegación de nivel superior [tabs](navigation#tabs). - - Anclas de la barra lateral [anchors](es/navigation#anchors). + + Barra lateral [anchors](navigation#anchors). - - [Menús desplegables](es/navigation#dropdowns) para agrupar contenido relacionado. + + [Dropdowns](navigation#dropdowns) para agrupar contenido relacionado. - - Selector de producto para sitios con varios [productos](es/navigation#products). + + Selector de productos para sitios con múltiples [products](navigation#products). - [Groups](es/navigation#groups) para organizar el contenido en secciones. + [Groups](navigation#groups) para organizar contenido en secciones. - - [Páginas](es/navigation#pages) individuales que conforman tu documentación. + + Páginas [pages](navigation#pages) individuales que componen tu documentación. - Configuración de interacción del usuario para los elementos de navegación. + Configuración de interacción del usuario para elementos de navegación. - + - Controla el comportamiento de navegación automática al seleccionar grupos de navegación. Establece `true` para forzar la navegación a la primera página cuando se expanda un grupo de navegación. Establece `false` para evitar la navegación y solo expandir o contraer el grupo. Déjalo sin definir para usar el comportamiento predeterminado del tema. + Controla el comportamiento de navegación automática al seleccionar grupos de navegación. Establece a `true` para forzar la navegación a la primera página cuando se expande un grupo de navegación. Establece a `false` para prevenir la navegación y solo expandir o colapsar el grupo. Deja sin establecer para usar el comportamiento predeterminado del tema. @@ -574,9 +564,9 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Contenido del pie de página y enlaces a redes sociales. - + - Perfiles de redes sociales para mostrar en el pie de página. Cada key es el nombre de una plataforma y cada value es la URL de tu perfil. Por ejemplo: + Perfiles de redes sociales para mostrar en el pie de página. Cada clave es un nombre de plataforma y cada valor es la URL de tu perfil. Por ejemplo: ```json { @@ -590,9 +580,9 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Enlaces para mostrar en el pie de página. - + - Título de la columna. + Título del encabezado para la columna. Longitud mínima: 1 @@ -600,7 +590,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Enlaces para mostrar en la columna. - + Texto del enlace. @@ -618,21 +608,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Banner del sitio mostrado en la parte superior de las páginas. + Banner para todo el sitio que se muestra en la parte superior de las páginas. - El contenido del banner. Admite texto sin formato y formato Markdown. Por ejemplo: + El contenido del banner. Admite texto plano y formato Markdown. Por ejemplo: ```json { - "content": "🚀 ¡El banner está activo! [Más información](mintlify.com)" + "content": "🚀 Banner is live! [Learn more](mintlify.com)" } ``` - Indica si los usuarios pueden descartar el banner. De forma predeterminada es `false`. + Si los usuarios pueden descartar el banner. Por defecto es `false`. @@ -640,56 +630,54 @@ Esta sección contiene la referencia completa del archivo `docs.json`. Redirecciones para páginas movidas, renombradas o eliminadas. - + - Ruta de origen desde la que redirigir. Ejemplo: `/old-page` + Ruta de origen para redirigir desde. Ejemplo: `/old-page` - Ruta de destino a la que redirigir. Ejemplo: `/new-page` + Ruta de destino para redirigir hacia. Ejemplo: `/new-page` - Indica si se debe usar una redirección permanente (301). De forma predeterminada es `true`. + Si usar una redirección permanente (301). Por defecto es `true`. - Menú contextual para contenido optimizado con IA e integraciones. + Menú contextual para contenido optimizado para IA e integraciones. Acciones disponibles en el menú contextual. La primera opción aparece como predeterminada. - * `copy`: Copia la página actual como Markdown en el portapapeles. - * `view`: Muestra la página actual como Markdown en una nueva pestaña. - * `chatgpt`: Envía el contenido de la página actual a ChatGPT. - * `claude`: Envía el contenido de la página actual a Claude. - * `perplexity`: Envía el contenido de la página actual a Perplexity. - * `mcp`: Copia la URL de tu servidor MCP en el portapapeles. + * `copy`: Copiar la página actual como Markdown al portapapeles. + * `view`: Ver la página actual como Markdown en una nueva pestaña. + * `chatgpt`: Enviar el contenido de la página actual a ChatGPT. + * `claude`: Enviar el contenido de la página actual a Claude. + * `perplexity`: Enviar el contenido de la página actual a Perplexity. + * `mcp`: Copia la URL de tu servidor MCP al portapapeles. * `cursor`: Instala tu servidor MCP alojado en Cursor. * `vscode`: Instala tu servidor MCP alojado en VSCode. - Menú contextual + Contextual Menu - El menú contextual solo está disponible en implementaciones de vista previa y de producción. + El menú contextual solo está disponible en despliegues de vista previa y producción. -
- ### Configuraciones de la API -
+### Configuraciones de API - Configuración de la documentación de la API y del área de pruebas interactiva. + Documentación de API y configuración del playground interactivo. - Archivos de especificación OpenAPI para generar la documentación de la API. Puede ser una única URL/ruta o una matriz de URL/rutas. + Archivos de especificación OpenAPI para generar documentación de API. Puede ser una sola URL/ruta o un array de URLs/rutas. @@ -699,15 +687,15 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Directorio donde buscar archivos OpenAPI. + Directorio para buscar archivos OpenAPI. - No incluyas una barra inicial. + No incluir una barra diagonal inicial. - Archivos de especificación AsyncAPI para generar la documentación de la API. Puede ser una única URL/ruta o una matriz de URL/rutas. + Archivos de especificación AsyncAPI para generar documentación de API. Puede ser una sola URL/ruta o un array de URLs/rutas. @@ -717,57 +705,57 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Directorio donde buscar archivos AsyncAPI. + Directorio para buscar archivos AsyncAPI. - No incluyas una barra inicial. + No incluir una barra diagonal inicial. - Configuración de visualización de los parámetros de la API. + Configuración de visualización para parámetros de API. - Indica si se expanden todos los parámetros de forma predeterminada. El valor predeterminado es `closed`. + Si se deben expandir todos los parámetros por defecto. El valor predeterminado es `closed`. - Configuración del área de pruebas de la API. + Configuración del playground de API. - Modo de visualización del área de pruebas de la API. El valor predeterminado es `interactive`. + El modo de visualización del playground de API. El valor predeterminado es `interactive`. - Indica si las solicitudes de la API pasan por un servidor proxy. El valor predeterminado es `true`. + Si se deben pasar las solicitudes de API a través de un servidor proxy. El valor predeterminado es `true`. - Configuración de los ejemplos de API generados automáticamente. + Configuraciones para los ejemplos de API autogenerados. - Lenguajes de ejemplo para los fragmentos de API generados automáticamente + Lenguajes de ejemplo para los fragmentos de API autogenerados - Indica si se muestran los parámetros opcionales en los ejemplos de la API. El valor predeterminado es `all`. + Si se deben mostrar parámetros opcionales en los ejemplos de API. El valor predeterminado es `all`. - Indica si se precarga el área de pruebas de la API con datos de ejemplos de esquemas. Cuando está habilitado, el área de pruebas completa automáticamente los campos de la solicitud con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`. + Si se debe precompletar el playground de API con datos de ejemplos del esquema. Cuando está habilitado, el playground completa automáticamente los campos de solicitud con valores de ejemplo de tu especificación OpenAPI. El valor predeterminado es `false`. - Configuración para páginas de API generadas a partir de archivos `MDX`. + Configuraciones para páginas de API generadas a partir de archivos `MDX`. @@ -779,7 +767,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Nombre de la autenticación para solicitudes de API. + Nombre de autenticación para solicitudes de API. @@ -792,86 +780,82 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - +### SEO y búsqueda - Configuraciones de indexación para SEO. + Configuraciones de indexación SEO. - + - Metatags añadidos a cada página. Debe ser un par key-value válido. Consulta la [referencia de metatags comunes](/es/optimize/seo#common-meta-tags-reference) para ver las opciones. + Etiquetas meta añadidas a cada página. Debe ser un par clave-valor válido. Ver [referencia de etiquetas meta comunes](/es/optimize/seo#common-meta-tags-reference) para opciones. - Especifica qué páginas deben indexar los motores de búsqueda. Elige `navigable` para indexar solo las páginas que estén en la navigation de tu `docs.json` o elige `all` para indexar todas las páginas. De manera predeterminada, es `navigable`. + Especifica qué páginas deben indexar los motores de búsqueda. Elige `navigable` para indexar solo las páginas que están en tu navegación `docs.json` o elige `all` para indexar todas las páginas. El valor predeterminado es `navigable`. - Configuraciones de visualización de la búsqueda. + Configuración de visualización de búsqueda. - Texto de marcador de posición que se muestra en la barra de búsqueda. + Texto de marcador de posición para mostrar en la barra de búsqueda. -
- ### Integraciones -
+### Integraciones - + Integraciones de terceros. - - - Integración con Amplitude Analytics. + + + Integración de análisis de Amplitude. - Tu API key de Amplitude. + Tu clave API de Amplitude. - + Integración de enriquecimiento de datos de Clearbit. - Tu clave de API de Clearbit. + Tu clave API de Clearbit. - - Integración con Fathom Analytics. + + Integración de análisis de Fathom. - Tu ID del sitio en Fathom. + Tu ID de sitio de Fathom. - - Integración de Front Chat. + + Integración de chat de Front. - Tu ID del fragmento de Front Chat. + Tu ID de fragmento de Front chat. Longitud mínima: 6 - - Integración con Google Analytics 4. + + Integración de Google Analytics 4. @@ -883,19 +867,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - Integración con Google Tag Manager. + Integración de Google Tag Manager. - Tu ID de Google Tag Manager. + Tu ID de etiqueta de Google Tag Manager. Debe coincidir con el patrón: ^G - - Integración con Heap Analytics. + + Integración de análisis de Heap. @@ -904,7 +888,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - + Integración de Hotjar. @@ -913,67 +897,67 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - La versión del script de Hotjar. + Tu versión de script de Hotjar. - - Integración con Intercom. + + Integración de Intercom. - Tu ID de la aplicación de Intercom. + Tu ID de aplicación de Intercom. Longitud mínima: 6 - - Integración con Koala. + + Integración de Koala. - Tu clave de API pública de Koala. + Tu clave API pública de Koala. Longitud mínima: 2 - - Integración con LogRocket. + + Integración de LogRocket. - + - Tu ID de la app de LogRocket. + Tu ID de aplicación de LogRocket. - - Integración con Mixpanel. + + Integración de Mixpanel. - Tu token del proyecto de Mixpanel. + Tu token de proyecto de Mixpanel. - - Integración con Osano. + + Integración de Osano. - El origen del script de Osano. + Tu fuente de script de Osano. - - Integración de Analytics de Pirsch. + + Integración de análisis de Pirsch. @@ -982,14 +966,14 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - - Integración con PostHog. + + Integración de PostHog. - Tu API key de PostHog. + Tu clave API de PostHog. - Debe coincidir con el patrón: ^phc_ + Debe coincidir con el patrón: ^phc\_ @@ -998,12 +982,12 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - - Integración con Plausible Analytics. + + Integración de análisis de Plausible. - Tu domain de Plausible. + Tu dominio de Plausible. @@ -1012,22 +996,22 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - - Integración con Segment. + + Integración de Segment. - Tu key de Segment. + Tu clave de Segment. - + Configuración de telemetría. - + - Indica si se habilita la telemetría. + Si se debe habilitar la telemetría. @@ -1037,32 +1021,29 @@ Esta sección contiene la referencia completa del archivo `docs.json`. - key de la cookie. + Clave para cookies. - value de la cookie. + Valor para cookies. -
- ### Errores -
+### Errores - Configuración del manejo de errores. + Configuración de manejo de errores. - + - Manejo del error 404 "Página no encontrada". + Manejo de error 404 "Página no encontrada". - Indica si se debe redirigir automáticamente a la página de inicio cuando no se - encuentre una página. + Si se debe redirigir automáticamente a la página de inicio cuando no se encuentra una página. @@ -1077,9 +1058,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. -
- ## Ejemplos -
+## Ejemplos @@ -1088,7 +1067,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "$schema": "https://mintlify.com/docs.json", "theme": "maple", "name": "Example Co.", - "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.", + "description": "Example Co. is a company that provides example content and placeholder text.", "colors": { "primary": "#3B82F6", "light": "#F8FAFC", @@ -1097,19 +1076,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "navigation": { "dropdowns": [ { - "dropdown": "Documentación", + "dropdown": "Documentation", "icon": "book", - "description": "Cómo usar el producto de Example Co.", + "description": "How to use the Example Co. product", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": [ "index", "quickstart" ] }, { - "group": "Personalización", + "group": "Customization", "pages": [ "settings", "users", @@ -1117,7 +1096,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "group": "Facturación", + "group": "Billing", "pages": [ "billing/overview", "billing/payments", @@ -1127,9 +1106,9 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "dropdown": "Cambios", + "dropdown": "Changelog", "icon": "history", - "description": "Actualizaciones y cambios", + "description": "Updates and changes", "pages": [ "changelog" ] @@ -1144,13 +1123,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "navbar": { "links": [ { - "label": "Comunidad", + "label": "Community", "href": "https://example.com/community" } ], "primary": { "type": "button", - "label": "Comenzar", + "label": "Get Started", "href": "https://example.com/start" } }, @@ -1163,27 +1142,27 @@ Esta sección contiene la referencia completa del archivo `docs.json`. }, "links": [ { - "header": "Recursos", + "header": "Resources", "items": [ { - "label": "Clientes", + "label": "Customers", "href": "https://example.com/customers" }, { - "label": "Empresarial", + "label": "Enterprise", "href": "https://example.com/enterprise" }, { - "label": "Solicitar vista previa", + "label": "Request Preview", "href": "https://example.com/preview" } ] }, { - "header": "Empresa", + "header": "Company", "items": [ { - "label": "Empleos", + "label": "Careers", "href": "https://example.com/careers" }, { @@ -1191,7 +1170,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "href": "https://example.com/blog" }, { - "label": "Política de privacidad", + "label": "Privacy Policy", "href": "https://example.com/legal/privacy" } ] @@ -1224,21 +1203,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "errors": { "404": { "redirect": false, - "title": "No se puede encontrar", - "description": "¿Qué **pasó** con esta _página_?" + "title": "I can't be found", + "description": "What ever **happened** to this _page_?" } } } ``` - + ```json title="docs.json" wrap lines highlight={43-61, 72-79} { "$schema": "https://mintlify.com/docs.json", "theme": "maple", "name": "Example Co.", - "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.", + "description": "Example Co. is a company that provides example content and placeholder text.", "colors": { "primary": "#3B82F6", "light": "#F8FAFC", @@ -1247,19 +1226,19 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "navigation": { "dropdowns": [ { - "dropdown": "Documentación", + "dropdown": "Documentation", "icon": "book", - "description": "Cómo usar el producto de Example Co.", + "description": "How to use the Example Co. product", "groups": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": [ "index", "quickstart" ] }, { - "group": "Personalización", + "group": "Customization", "pages": [ "settings", "users", @@ -1267,7 +1246,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "group": "Facturación", + "group": "Billing", "pages": [ "billing/overview", "billing/payments", @@ -1277,12 +1256,12 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "dropdown": "Referencia de API", + "dropdown": "API reference", "icon": "terminal", - "description": "Cómo usar la API de Example Co.", + "description": "How to use the Example Co. API", "groups": [ { - "group": "Referencia de API", + "group": "API reference", "pages": [ "api-reference/introduction" ] @@ -1296,9 +1275,9 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "dropdown": "Cambios", + "dropdown": "Changelog", "icon": "history", - "description": "Actualizaciones y cambios", + "description": "Updates and changes", "pages": [ "changelog" ] @@ -1321,13 +1300,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "navbar": { "links": [ { - "label": "Comunidad", + "label": "Community", "href": "https://example.com/community" } ], "primary": { "type": "button", - "label": "Comenzar", + "label": "Get Started", "href": "https://example.com/start" } }, @@ -1340,27 +1319,27 @@ Esta sección contiene la referencia completa del archivo `docs.json`. }, "links": [ { - "header": "Recursos", + "header": "Resources", "items": [ { - "label": "Clientes", + "label": "Customers", "href": "https://example.com/customers" }, { - "label": "Empresarial", + "label": "Enterprise", "href": "https://example.com/enterprise" }, { - "label": "Solicitar Vista Previa", + "label": "Request Preview", "href": "https://example.com/preview" } ] }, { - "header": "Empresa", + "header": "Company", "items": [ { - "label": "Carreras", + "label": "Careers", "href": "https://example.com/careers" }, { @@ -1368,7 +1347,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "href": "https://example.com/blog" }, { - "label": "Política de Privacidad", + "label": "Privacy Policy", "href": "https://example.com/legal/privacy" } ] @@ -1401,21 +1380,21 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "errors": { "404": { "redirect": false, - "title": "No se puede encontrar", - "description": "¿Qué **pasó** con esta _página_?" + "title": "I can't be found", + "description": "What ever **happened** to this _page_?" } } } ``` - + ```json title="docs.json" wrap lines { "$schema": "https://mintlify.com/docs.json", "theme": "maple", "name": "Example Co.", - "description": "Example Co. es una empresa que proporciona contenido de ejemplo y texto de marcador de posición.", + "description": "Example Co. is a company that provides example content and placeholder text.", "colors": { "primary": "#3B82F6", "light": "#F8FAFC", @@ -1425,11 +1404,11 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "global": { "anchors": [ { - "anchor": "Documentación", + "anchor": "Documentation", "href": "https://mintlify.com/docs" }, { - "anchor": "Cambios", + "anchor": "Changelog", "href": "https://mintlify.com/docs/changelog" } ] @@ -1439,20 +1418,20 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "language": "en", "dropdowns": [ { - "dropdown": "Documentación", + "dropdown": "Documentation", "icon": "book", - "description": "Cómo usar el producto de Example Co.", + "description": "How to use the Example Co. product", "pages": [ { - "group": "Primeros pasos", + "group": "Getting started", "pages": ["index", "quickstart"] }, { - "group": "Personalización", + "group": "Customization", "pages": ["settings", "users", "features"] }, { - "group": "Facturación", + "group": "Billing", "pages": [ "billing/overview", "billing/payments", @@ -1462,9 +1441,9 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "dropdown": "Cambios", + "dropdown": "Changelog", "icon": "history", - "description": "Actualizaciones y cambios", + "description": "Updates and changes", "pages": ["changelog"] } ] @@ -1478,7 +1457,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "description": "Cómo usar el producto de Example Co.", "pages": [ { - "group": "Primeros pasos", + "group": "Comenzando", "pages": ["es/index", "es/quickstart"] }, { @@ -1486,7 +1465,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "pages": ["es/settings", "es/users", "es/features"] }, { - "group": "Facturación", + "group": "Billing", "pages": [ "es/billing/overview", "es/billing/payments", @@ -1496,7 +1475,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. ] }, { - "dropdown": "Cambios", + "dropdown": "Changelog", "icon": "history", "description": "Actualizaciones y cambios", "pages": ["es/changelog"] @@ -1513,13 +1492,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "navbar": { "links": [ { - "label": "Comunidad", + "label": "Community", "href": "https://example.com/community" } ], "primary": { "type": "button", - "label": "Empezar", + "label": "Get Started", "href": "https://example.com/start" } }, @@ -1532,27 +1511,27 @@ Esta sección contiene la referencia completa del archivo `docs.json`. }, "links": [ { - "header": "Recursos", + "header": "Resources", "items": [ { - "label": "Clientes", + "label": "Customers", "href": "https://example.com/customers" }, { - "label": "Empresarial", + "label": "Enterprise", "href": "https://example.com/enterprise" }, { - "label": "Solicitar vista previa", + "label": "Request Preview", "href": "https://example.com/preview" } ] }, { - "header": "Empresa", + "header": "Company", "items": [ { - "label": "Carreras", + "label": "Careers", "href": "https://example.com/careers" }, { @@ -1560,7 +1539,7 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "href": "https://example.com/blog" }, { - "label": "Política de privacidad", + "label": "Privacy Policy", "href": "https://example.com/legal/privacy" } ] @@ -1588,8 +1567,8 @@ Esta sección contiene la referencia completa del archivo `docs.json`. "errors": { "404": { "redirect": false, - "title": "No se puede encontrar", - "description": "¿Qué **pasó** con esta _página_?" + "title": "I can't be found", + "description": "What ever **happened** to this _page_?" } } } @@ -1597,15 +1576,13 @@ Esta sección contiene la referencia completa del archivo `docs.json`. -
- ## Actualización desde `mint.json` -
+## Actualizando desde `mint.json` -Si tu proyecto de documentación usa el archivo `mint.json` en desuso, sigue estos pasos para actualizar a `docs.json`. +Si tu proyecto de documentación utiliza el obsoleto `mint.json` archivo, sigue estos pasos para actualizar a `docs.json`. - - Si aún no has instalado la [CLI](/es/installation), instálala ahora: + + Si no has instalado el [CLI](/es/installation), instálalo ahora: ```bash npm @@ -1621,24 +1598,24 @@ Si tu proyecto de documentación usa el archivo `mint.json` en desuso, sigue est ``` - Si ya tienes la CLI instalada, asegúrate de que esté actualizada: + Si ya tienes el CLI instalado, asegúrate de que esté actualizado: ```bash mint update ``` - + En tu repositorio de documentación, ejecuta: ```bash mint upgrade ``` - Este comando creará un archivo `docs.json` a partir de tu `mint.json` existente. Revisa el archivo generado para asegurarte de que toda la configuración sea correcta. + Este comando creará un `docs.json` archivo a partir de tu `mint.json` existente. Revisa el archivo generado para asegurarte de que todas las configuraciones sean correctas. - - Después de verificar que tu `docs.json` esté configurado correctamente, puedes eliminar de forma segura tu antiguo archivo `mint.json`. + + Después de verificar que tu `docs.json` está configurado correctamente, puedes eliminar con seguridad tu antiguo `mint.json` archivo. - \ No newline at end of file +