diff --git a/docs.json b/docs.json index e490e772b..d680f9057 100644 --- a/docs.json +++ b/docs.json @@ -276,7 +276,9 @@ { "group": "API Reference", "icon": "file-json", - "pages": ["api-reference/introduction"] + "pages": [ + "api-reference/introduction" + ] }, { "group": "Admin", @@ -311,7 +313,9 @@ { "group": "Changelog", "icon": "calendar", - "pages": ["changelog"] + "pages": [ + "changelog" + ] } ] } @@ -324,226 +328,253 @@ "tab": "Documentation", "groups": [ { - "group": "Prise en main", + "group": "Commencer", + "icon": "rocket", "pages": [ "fr/index", "fr/quickstart", "fr/installation", { - "group": "Éditeur web", - "icon": "mouse-pointer-2", + "group": "Éditeur visuel", "pages": [ "fr/editor/getting-started", - "fr/editor/git-concepts", - "fr/editor/branches", "fr/editor/content-management", "fr/editor/publishing", "fr/editor/keyboard-shortcuts", "fr/editor/troubleshooting" ] - } + }, + "fr/ai-native", + "fr/migration" ] }, { - "group": "Configuration de base", + "group": "Organiser", + "icon": "map", "pages": [ - "fr/settings", - "fr/pages", - "fr/navigation", - "fr/themes", - "fr/settings/custom-domain" + "fr/organize/settings", + "fr/organize/navigation", + "fr/organize/pages", + "fr/organize/hidden-pages" ] }, { - "group": "Optimisation de l’IA", + "group": "Personnaliser", + "icon": "paint-bucket", "pages": [ - "fr/guides/assistant", - "fr/ai/agent", - "fr/ai/llmstxt", - "fr/ai/contextual-menu", - "fr/ai/model-context-protocol", - "fr/ai/markdown-export", - "fr/guides/geo", - "fr/guides/claude-code", - "fr/guides/cursor", - "fr/guides/windsurf" + "fr/customize/custom-domain", + "fr/customize/themes", + "fr/customize/custom-scripts", + "fr/customize/react-components", + { + "group": "Accès au Dashboard", + "pages": [ + "fr/dashboard/sso", + "fr/dashboard/permissions", + "fr/dashboard/roles" + ] + }, + "fr/customize/custom-404-page" ] }, { - "group": "Composants", - "pages": [ - "fr/text", - "fr/image-embeds", - "fr/components/files", - "fr/list-table", - "fr/code", - "fr/reusable-snippets", - "fr/components/accordions", - "fr/components/callouts", - "fr/components/cards", - "fr/components/columns", - "fr/components/code-groups", - "fr/components/examples", - "fr/components/expandables", - "fr/components/fields", - "fr/components/frames", - "fr/components/icons", - "fr/components/mermaid-diagrams", - "fr/components/panel", - "fr/components/steps", - "fr/components/tabs", - "fr/components/tooltips", - "fr/components/update", - "fr/components/banner" + "group": "Créer un objet", + "icon": "pen-line", + "pages": [ + "fr/create/text", + "fr/create/code", + "fr/create/image-embeds", + "fr/create/files", + "fr/create/list-table", + { + "group": "Composants", + "pages": [ + "fr/components/accordions", + "fr/components/banner", + "fr/components/callouts", + "fr/components/cards", + "fr/components/code-groups", + "fr/components/columns", + "fr/components/examples", + "fr/components/expandables", + "fr/components/fields", + "fr/components/frames", + "fr/components/icons", + "fr/components/mermaid-diagrams", + "fr/components/panel", + "fr/components/responses", + "fr/components/steps", + "fr/components/tabs", + "fr/components/tooltips", + "fr/components/update" + ] + }, + "fr/create/reusable-snippets", + "fr/create/broken-links", + "fr/create/changelogs" ] }, { - "group": "Pages d’API", + "group": "Documenter des API", + "icon": "file-json", "pages": [ "fr/api-playground/overview", "fr/api-playground/openapi-setup", - "fr/api-playground/migrating-from-mdx", + "fr/api-playground/complex-data-types", + "fr/api-playground/adding-sdk-examples", + "fr/api-playground/managing-page-visibility", + "fr/api-playground/multiple-responses", { - "group": "Personnalisation", - "icon": "wrench", + "group": "MDX", "pages": [ - "fr/api-playground/customization/complex-data-types", - "fr/api-playground/customization/adding-sdk-examples", - "fr/api-playground/customization/managing-page-visibility", - "fr/api-playground/customization/multiple-responses" + "fr/api-playground/mdx/configuration", + "fr/api-playground/mdx/authentication" ] }, { "group": "AsyncAPI", - "icon": "webhook", "pages": [ "fr/api-playground/asyncapi/setup", "fr/api-playground/asyncapi/playground" ] }, - { - "group": "MDX", - "icon": "markdown", - "pages": [ - "fr/api-playground/mdx/configuration", - "fr/api-playground/mdx/authentication" - ] - }, "fr/api-playground/troubleshooting" ] }, { - "group": "Authentification et personnalisation", - "pages": [ - "fr/authentication-personalization/authentication-setup", - "fr/authentication-personalization/personalization-setup" - ] - }, - { - "group": "Guides", + "group": "Déployer", + "icon": "boxes", "pages": [ - "fr/guides/migration", - { - "group": "Dashboard Analytics", - "icon": "chart-line", - "pages": [ - "fr/analytics/overview", - "fr/analytics/feedback", - "fr/analytics/search", - "fr/analytics/improving-docs" - ] - }, - "fr/react-components", - "fr/settings/custom-scripts", - "fr/settings/seo", - "fr/guides/changelogs", - "fr/guides/hidden-pages", - "fr/settings/broken-links", - "fr/settings/custom-404-page", - "fr/guides/monorepo", + "fr/deploy/deployments", + "fr/deploy/preview-deployments", { "group": "Sous-répertoire personnalisé", - "icon": "folder", - "pages": [ - "fr/advanced/subpath/cloudflare", - "fr/advanced/subpath/route53-cloudfront", - "fr/advanced/subpath/vercel", - "fr/guides/csp-configuration" - ] - }, - { - "group": "Accès au Dashboard", - "icon": "gauge", "pages": [ - "fr/advanced/dashboard/sso", - "fr/advanced/dashboard/permissions", - "fr/advanced/dashboard/roles" + "fr/deploy/cloudflare", + "fr/deploy/route53-cloudfront", + "fr/deploy/vercel", + "fr/deploy/reverse-proxy", + "fr/deploy/csp-configuration" ] }, - "fr/guides/deployments", - "fr/pdf-exports", - "fr/contact-support" + "fr/deploy/authentication-setup", + "fr/deploy/personalization-setup", + "fr/deploy/monorepo", + "fr/deploy/ci", + "fr/deploy/github", + "fr/deploy/gitlab" ] }, { - "group": "Intégrations", + "group": "Optimiser", + "icon": "wrench", "pages": [ { - "group": "Analytics", - "icon": "chart-no-axes-combined", - "pages": [ - "fr/integrations/analytics/overview", - "fr/integrations/analytics/amplitude", - "fr/integrations/analytics/clearbit", - "fr/integrations/analytics/fathom", - "fr/integrations/analytics/google-analytics", - "fr/integrations/analytics/google-tag-manager", - "fr/integrations/analytics/heap", - "fr/integrations/analytics/hightouch", - "fr/integrations/analytics/hotjar", - "fr/integrations/analytics/koala", - "fr/integrations/analytics/logrocket", - "fr/integrations/analytics/mixpanel", - "fr/integrations/analytics/pirsch", - "fr/integrations/analytics/plausible", - "fr/integrations/analytics/posthog", - "fr/integrations/analytics/segment" - ] - }, - { - "group": "SDK", - "icon": "folder-code", + "group": "IA", "pages": [ - "fr/integrations/sdks/speakeasy", - "fr/integrations/sdks/stainless" + "fr/ai/assistant", + "fr/ai/agent", + "fr/ai/llmstxt", + "fr/ai/contextual-menu", + "fr/ai/model-context-protocol", + "fr/ai/markdown-export" ] }, { - "group": "Assistance", - "icon": "messages-square", + "group": "Analytics", "pages": [ - "fr/integrations/support/overview", - "fr/integrations/support/intercom", - "fr/integrations/support/front" + "fr/analytics/overview", + "fr/analytics/feedback", + "fr/analytics/search" ] }, + "fr/optimize/seo", + "fr/optimize/pdf-exports", { - "group": "Confidentialité", - "icon": "folder-lock", + "group": "Intégrations", "pages": [ - "fr/integrations/privacy/overview", - "fr/integrations/privacy/osano" + { + "group": "Analytics", + "pages": [ + "fr/integrations/analytics/overview", + "fr/integrations/analytics/amplitude", + "fr/integrations/analytics/clearbit", + "fr/integrations/analytics/fathom", + "fr/integrations/analytics/google-analytics", + "fr/integrations/analytics/google-tag-manager", + "fr/integrations/analytics/heap", + "fr/integrations/analytics/hightouch", + "fr/integrations/analytics/hotjar", + "fr/integrations/analytics/koala", + "fr/integrations/analytics/logrocket", + "fr/integrations/analytics/mixpanel", + "fr/integrations/analytics/pirsch", + "fr/integrations/analytics/plausible", + "fr/integrations/analytics/posthog", + "fr/integrations/analytics/segment" + ] + }, + { + "group": "SDK", + "pages": [ + "fr/integrations/sdks/speakeasy", + "fr/integrations/sdks/stainless" + ] + }, + { + "group": "Assistance", + "pages": [ + "fr/integrations/support/overview", + "fr/integrations/support/intercom", + "fr/integrations/support/front" + ] + }, + { + "group": "Confidentialité", + "pages": [ + "fr/integrations/privacy/overview", + "fr/integrations/privacy/osano" + ] + } ] } ] + } + ] + }, + { + "tab": "Guides", + "groups": [ + { + "group": "IA", + "icon": "bot", + "pages": [ + "fr/guides/geo", + "fr/guides/claude-code", + "fr/guides/cursor", + "fr/guides/windsurf" + ] }, { - "group": "Gestion de versions et CI/CD", + "group": "Documentation de l’API", + "icon": "file-json", "pages": [ - "fr/settings/github", - "fr/settings/gitlab", - "fr/settings/ci", - "fr/settings/preview-deployments" + "fr/guides/migrating-from-mdx" + ] + }, + { + "group": "Analytics", + "icon": "chart-line", + "pages": [ + "fr/guides/improving-docs" + ] + }, + { + "group": "Git", + "icon": "git-merge", + "pages": [ + "fr/guides/git-concepts", + "fr/guides/branches" ] } ] @@ -553,12 +584,14 @@ "groups": [ { "group": "Référence de l’API", + "icon": "file-json", "pages": [ "fr/api-reference/introduction" ] }, { "group": "Admin", + "icon": "activity", "pages": [ "fr/api-reference/update/trigger", "fr/api-reference/update/status" @@ -566,6 +599,7 @@ }, { "group": "Agent", + "icon": "pen-line", "pages": [ "fr/api-reference/agent/create-agent-job", "fr/api-reference/agent/get-agent-job", @@ -574,6 +608,7 @@ }, { "group": "Assistant", + "icon": "bot-message-square", "pages": [ "fr/api-reference/assistant/create-assistant-message", "fr/api-reference/assistant/search" @@ -586,7 +621,10 @@ "groups": [ { "group": "Journal des modifications", - "pages": ["fr/changelog"] + "icon": "calendar", + "pages": [ + "fr/changelog" + ] } ] } @@ -599,226 +637,253 @@ "tab": "Documentación", "groups": [ { - "group": "Primeros pasos", + "group": "Comenzar", + "icon": "rocket", "pages": [ "es/index", "es/quickstart", "es/installation", { - "group": "Editor web", - "icon": "mouse-pointer-2", + "group": "Editor visual", "pages": [ "es/editor/getting-started", - "es/editor/git-concepts", - "es/editor/branches", "es/editor/content-management", "es/editor/publishing", "es/editor/keyboard-shortcuts", "es/editor/troubleshooting" ] - } + }, + "es/ai-native", + "es/migration" ] }, { - "group": "Configuración básica", + "group": "Organizar", + "icon": "map", "pages": [ - "es/settings", - "es/pages", - "es/navigation", - "es/themes", - "es/settings/custom-domain" + "es/organize/settings", + "es/organize/navigation", + "es/organize/pages", + "es/organize/hidden-pages" ] }, { - "group": "Optimización de IA", + "group": "Personalizar", + "icon": "paint-bucket", "pages": [ - "es/guides/assistant", - "es/ai/agent", - "es/ai/llmstxt", - "es/ai/contextual-menu", - "es/ai/model-context-protocol", - "es/ai/markdown-export", - "es/guides/geo", - "es/guides/claude-code", - "es/guides/cursor", - "es/guides/windsurf" + "es/customize/custom-domain", + "es/customize/themes", + "es/customize/custom-scripts", + "es/customize/react-components", + { + "group": "Acceso al dashboard", + "pages": [ + "es/dashboard/sso", + "es/dashboard/permissions", + "es/dashboard/roles" + ] + }, + "es/customize/custom-404-page" ] }, { - "group": "Componentes", - "pages": [ - "es/text", - "es/image-embeds", - "es/components/files", - "es/list-table", - "es/code", - "es/reusable-snippets", - "es/components/accordions", - "es/components/callouts", - "es/components/cards", - "es/components/columns", - "es/components/code-groups", - "es/components/examples", - "es/components/expandables", - "es/components/fields", - "es/components/frames", - "es/components/icons", - "es/components/mermaid-diagrams", - "es/components/panel", - "es/components/steps", - "es/components/tabs", - "es/components/tooltips", - "es/components/update", - "es/components/banner" + "group": "Crear contenido", + "icon": "pen-line", + "pages": [ + "es/create/text", + "es/create/code", + "es/create/image-embeds", + "es/create/files", + "es/create/list-table", + { + "group": "Componentes", + "pages": [ + "es/components/accordions", + "es/components/banner", + "es/components/callouts", + "es/components/cards", + "es/components/code-groups", + "es/components/columns", + "es/components/examples", + "es/components/expandables", + "es/components/fields", + "es/components/frames", + "es/components/icons", + "es/components/mermaid-diagrams", + "es/components/panel", + "es/components/responses", + "es/components/steps", + "es/components/tabs", + "es/components/tooltips", + "es/components/update" + ] + }, + "es/create/reusable-snippets", + "es/create/broken-links", + "es/create/changelogs" ] }, { - "group": "Páginas de API", + "group": "Documentar APIs", + "icon": "file-json", "pages": [ "es/api-playground/overview", "es/api-playground/openapi-setup", - "es/api-playground/migrating-from-mdx", + "es/api-playground/complex-data-types", + "es/api-playground/adding-sdk-examples", + "es/api-playground/managing-page-visibility", + "es/api-playground/multiple-responses", { - "group": "Personalización", - "icon": "wrench", + "group": "MDX", "pages": [ - "es/api-playground/customization/complex-data-types", - "es/api-playground/customization/adding-sdk-examples", - "es/api-playground/customization/managing-page-visibility", - "es/api-playground/customization/multiple-responses" + "es/api-playground/mdx/configuration", + "es/api-playground/mdx/authentication" ] }, { "group": "AsyncAPI", - "icon": "webhook", "pages": [ "es/api-playground/asyncapi/setup", "es/api-playground/asyncapi/playground" ] }, - { - "group": "MDX", - "icon": "markdown", - "pages": [ - "es/api-playground/mdx/configuration", - "es/api-playground/mdx/authentication" - ] - }, "es/api-playground/troubleshooting" ] }, { - "group": "Autenticación y personalización", - "pages": [ - "es/authentication-personalization/authentication-setup", - "es/authentication-personalization/personalization-setup" - ] - }, - { - "group": "Guías", + "group": "Implementar", + "icon": "boxes", "pages": [ - "es/guides/migration", - { - "group": "Analytics dashboard", - "icon": "chart-line", - "pages": [ - "es/analytics/overview", - "es/analytics/feedback", - "es/analytics/search", - "es/analytics/improving-docs" - ] - }, - "es/react-components", - "es/settings/custom-scripts", - "es/settings/seo", - "es/guides/changelogs", - "es/guides/hidden-pages", - "es/settings/broken-links", - "es/settings/custom-404-page", - "es/guides/monorepo", + "es/deploy/deployments", + "es/deploy/preview-deployments", { "group": "Subdirectorio personalizado", - "icon": "folder", - "pages": [ - "es/advanced/subpath/cloudflare", - "es/advanced/subpath/route53-cloudfront", - "es/advanced/subpath/vercel", - "es/guides/csp-configuration" - ] - }, - { - "group": "Acceso al dashboard", - "icon": "gauge", "pages": [ - "es/advanced/dashboard/sso", - "es/advanced/dashboard/permissions", - "es/advanced/dashboard/roles" + "es/deploy/cloudflare", + "es/deploy/route53-cloudfront", + "es/deploy/vercel", + "es/deploy/reverse-proxy", + "es/deploy/csp-configuration" ] }, - "es/guides/deployments", - "es/pdf-exports", - "es/contact-support" + "es/deploy/authentication-setup", + "es/deploy/personalization-setup", + "es/deploy/monorepo", + "es/deploy/ci", + "es/deploy/github", + "es/deploy/gitlab" ] }, { - "group": "Integraciones", + "group": "Optimizar", + "icon": "wrench", "pages": [ { - "group": "Analytics", - "icon": "chart-no-axes-combined", - "pages": [ - "es/integrations/analytics/overview", - "es/integrations/analytics/amplitude", - "es/integrations/analytics/clearbit", - "es/integrations/analytics/fathom", - "es/integrations/analytics/google-analytics", - "es/integrations/analytics/google-tag-manager", - "es/integrations/analytics/heap", - "es/integrations/analytics/hightouch", - "es/integrations/analytics/hotjar", - "es/integrations/analytics/koala", - "es/integrations/analytics/logrocket", - "es/integrations/analytics/mixpanel", - "es/integrations/analytics/pirsch", - "es/integrations/analytics/plausible", - "es/integrations/analytics/posthog", - "es/integrations/analytics/segment" - ] - }, - { - "group": "SDKs", - "icon": "folder-code", + "group": "IA", "pages": [ - "es/integrations/sdks/speakeasy", - "es/integrations/sdks/stainless" + "es/ai/assistant", + "es/ai/agent", + "es/ai/llmstxt", + "es/ai/contextual-menu", + "es/ai/model-context-protocol", + "es/ai/markdown-export" ] }, { - "group": "Soporte", - "icon": "messages-square", + "group": "Analytics", "pages": [ - "es/integrations/support/overview", - "es/integrations/support/intercom", - "es/integrations/support/front" + "es/analytics/overview", + "es/analytics/feedback", + "es/analytics/search" ] }, + "es/optimize/seo", + "es/optimize/pdf-exports", { - "group": "Privacidad", - "icon": "folder-lock", + "group": "Integraciones", "pages": [ - "es/integrations/privacy/overview", - "es/integrations/privacy/osano" + { + "group": "Analytics", + "pages": [ + "es/integrations/analytics/overview", + "es/integrations/analytics/amplitude", + "es/integrations/analytics/clearbit", + "es/integrations/analytics/fathom", + "es/integrations/analytics/google-analytics", + "es/integrations/analytics/google-tag-manager", + "es/integrations/analytics/heap", + "es/integrations/analytics/hightouch", + "es/integrations/analytics/hotjar", + "es/integrations/analytics/koala", + "es/integrations/analytics/logrocket", + "es/integrations/analytics/mixpanel", + "es/integrations/analytics/pirsch", + "es/integrations/analytics/plausible", + "es/integrations/analytics/posthog", + "es/integrations/analytics/segment" + ] + }, + { + "group": "SDK", + "pages": [ + "es/integrations/sdks/speakeasy", + "es/integrations/sdks/stainless" + ] + }, + { + "group": "Soporte", + "pages": [ + "es/integrations/support/overview", + "es/integrations/support/intercom", + "es/integrations/support/front" + ] + }, + { + "group": "Privacidad", + "pages": [ + "es/integrations/privacy/overview", + "es/integrations/privacy/osano" + ] + } ] } ] + } + ] + }, + { + "tab": "Guías", + "groups": [ + { + "group": "IA", + "icon": "bot", + "pages": [ + "es/guides/geo", + "es/guides/claude-code", + "es/guides/cursor", + "es/guides/windsurf" + ] }, { - "group": "Control de versiones y CI/CD", + "group": "Documentación de la API", + "icon": "file-json", "pages": [ - "es/settings/github", - "es/settings/gitlab", - "es/settings/ci", - "es/settings/preview-deployments" + "es/guides/migrating-from-mdx" + ] + }, + { + "group": "Analytics", + "icon": "chart-line", + "pages": [ + "es/guides/improving-docs" + ] + }, + { + "group": "Git", + "icon": "git-merge", + "pages": [ + "es/guides/git-concepts", + "es/guides/branches" ] } ] @@ -828,10 +893,14 @@ "groups": [ { "group": "Referencia de la API", - "pages": ["es/api-reference/introduction"] + "icon": "file-json", + "pages": [ + "es/api-reference/introduction" + ] }, { "group": "Administrador", + "icon": "activity", "pages": [ "es/api-reference/update/trigger", "es/api-reference/update/status" @@ -839,6 +908,7 @@ }, { "group": "Agente", + "icon": "pen-line", "pages": [ "es/api-reference/agent/create-agent-job", "es/api-reference/agent/get-agent-job", @@ -847,6 +917,7 @@ }, { "group": "assistant", + "icon": "bot-message-square", "pages": [ "es/api-reference/assistant/create-assistant-message", "es/api-reference/assistant/search" @@ -859,6 +930,7 @@ "groups": [ { "group": "Cambios", + "icon": "calendar", "pages": [ "es/changelog" ] @@ -874,226 +946,253 @@ "tab": "文档", "groups": [ { - "group": "快速开始", + "group": "开始使用", + "icon": "rocket", "pages": [ "zh/index", "zh/quickstart", "zh/installation", { - "group": "Web 编辑器", - "icon": "mouse-pointer-2", + "group": "可视化编辑器", "pages": [ "zh/editor/getting-started", - "zh/editor/git-concepts", - "zh/editor/branches", "zh/editor/content-management", "zh/editor/publishing", "zh/editor/keyboard-shortcuts", "zh/editor/troubleshooting" ] - } + }, + "zh/ai-native", + "zh/migration" ] }, { - "group": "核心配置", + "group": "组织", + "icon": "map", "pages": [ - "zh/settings", - "zh/pages", - "zh/navigation", - "zh/themes", - "zh/settings/custom-domain" + "zh/organize/settings", + "zh/organize/navigation", + "zh/organize/pages", + "zh/organize/hidden-pages" ] }, { - "group": "AI 优化", + "group": "自定义", + "icon": "paint-bucket", "pages": [ - "zh/guides/assistant", - "zh/ai/agent", - "zh/ai/llmstxt", - "zh/ai/contextual-menu", - "zh/ai/model-context-protocol", - "zh/ai/markdown-export", - "zh/guides/geo", - "zh/guides/claude-code", - "zh/guides/cursor", - "zh/guides/windsurf" + "zh/customize/custom-domain", + "zh/customize/themes", + "zh/customize/custom-scripts", + "zh/customize/react-components", + { + "group": "控制台访问", + "pages": [ + "zh/dashboard/sso", + "zh/dashboard/permissions", + "zh/dashboard/roles" + ] + }, + "zh/customize/custom-404-page" ] }, { - "group": "组件", - "pages": [ - "zh/text", - "zh/image-embeds", - "zh/components/files", - "zh/list-table", - "zh/code", - "zh/reusable-snippets", - "zh/components/accordions", - "zh/components/callouts", - "zh/components/cards", - "zh/components/columns", - "zh/components/code-groups", - "zh/components/examples", - "zh/components/expandables", - "zh/components/fields", - "zh/components/frames", - "zh/components/icons", - "zh/components/mermaid-diagrams", - "zh/components/panel", - "zh/components/steps", - "zh/components/tabs", - "zh/components/tooltips", - "zh/components/update", - "zh/components/banner" + "group": "创建对象", + "icon": "pen-line", + "pages": [ + "zh/create/text", + "zh/create/code", + "zh/create/image-embeds", + "zh/create/files", + "zh/create/list-table", + { + "group": "组件", + "pages": [ + "zh/components/accordions", + "zh/components/banner", + "zh/components/callouts", + "zh/components/cards", + "zh/components/code-groups", + "zh/components/columns", + "zh/components/examples", + "zh/components/expandables", + "zh/components/fields", + "zh/components/frames", + "zh/components/icons", + "zh/components/mermaid-diagrams", + "zh/components/panel", + "zh/components/responses", + "zh/components/steps", + "zh/components/tabs", + "zh/components/tooltips", + "zh/components/update" + ] + }, + "zh/create/reusable-snippets", + "zh/create/broken-links", + "zh/create/changelogs" ] }, { - "group": "API 页面", + "group": "文档 API", + "icon": "file-json", "pages": [ "zh/api-playground/overview", "zh/api-playground/openapi-setup", - "zh/api-playground/migrating-from-mdx", + "zh/api-playground/complex-data-types", + "zh/api-playground/adding-sdk-examples", + "zh/api-playground/managing-page-visibility", + "zh/api-playground/multiple-responses", { - "group": "自定义", - "icon": "wrench", + "group": "MDX", "pages": [ - "zh/api-playground/customization/complex-data-types", - "zh/api-playground/customization/adding-sdk-examples", - "zh/api-playground/customization/managing-page-visibility", - "zh/api-playground/customization/multiple-responses" + "zh/api-playground/mdx/configuration", + "zh/api-playground/mdx/authentication" ] }, { "group": "AsyncAPI", - "icon": "webhook", "pages": [ "zh/api-playground/asyncapi/setup", "zh/api-playground/asyncapi/playground" ] }, - { - "group": "MDX", - "icon": "markdown", - "pages": [ - "zh/api-playground/mdx/configuration", - "zh/api-playground/mdx/authentication" - ] - }, "zh/api-playground/troubleshooting" ] }, { - "group": "认证与个性化", - "pages": [ - "zh/authentication-personalization/authentication-setup", - "zh/authentication-personalization/personalization-setup" - ] - }, - { - "group": "指南", + "group": "部署", + "icon": "boxes", "pages": [ - "zh/guides/migration", - { - "group": "Analytics 控制台", - "icon": "chart-line", - "pages": [ - "zh/analytics/overview", - "zh/analytics/feedback", - "zh/analytics/search", - "zh/analytics/improving-docs" - ] - }, - "zh/react-components", - "zh/settings/custom-scripts", - "zh/settings/seo", - "zh/guides/changelogs", - "zh/guides/hidden-pages", - "zh/settings/broken-links", - "zh/settings/custom-404-page", - "zh/guides/monorepo", + "zh/deploy/deployments", + "zh/deploy/preview-deployments", { "group": "自定义子目录", - "icon": "folder", - "pages": [ - "zh/advanced/subpath/cloudflare", - "zh/advanced/subpath/route53-cloudfront", - "zh/advanced/subpath/vercel", - "zh/guides/csp-configuration" - ] - }, - { - "group": "控制台访问", - "icon": "gauge", "pages": [ - "zh/advanced/dashboard/sso", - "zh/advanced/dashboard/permissions", - "zh/advanced/dashboard/roles" + "zh/deploy/cloudflare", + "zh/deploy/route53-cloudfront", + "zh/deploy/vercel", + "zh/deploy/reverse-proxy", + "zh/deploy/csp-configuration" ] }, - "zh/guides/deployments", - "zh/pdf-exports", - "zh/contact-support" + "zh/deploy/authentication-setup", + "zh/deploy/personalization-setup", + "zh/deploy/monorepo", + "zh/deploy/ci", + "zh/deploy/github", + "zh/deploy/gitlab" ] }, { - "group": "集成", + "group": "优化", + "icon": "wrench", "pages": [ { - "group": "Analytics", - "icon": "chart-no-axes-combined", - "pages": [ - "zh/integrations/analytics/overview", - "zh/integrations/analytics/amplitude", - "zh/integrations/analytics/clearbit", - "zh/integrations/analytics/fathom", - "zh/integrations/analytics/google-analytics", - "zh/integrations/analytics/google-tag-manager", - "zh/integrations/analytics/heap", - "zh/integrations/analytics/hightouch", - "zh/integrations/analytics/hotjar", - "zh/integrations/analytics/koala", - "zh/integrations/analytics/logrocket", - "zh/integrations/analytics/mixpanel", - "zh/integrations/analytics/pirsch", - "zh/integrations/analytics/plausible", - "zh/integrations/analytics/posthog", - "zh/integrations/analytics/segment" - ] - }, - { - "group": "SDK", - "icon": "folder-code", + "group": "人工智能", "pages": [ - "zh/integrations/sdks/speakeasy", - "zh/integrations/sdks/stainless" + "zh/ai/assistant", + "zh/ai/agent", + "zh/ai/llmstxt", + "zh/ai/contextual-menu", + "zh/ai/model-context-protocol", + "zh/ai/markdown-export" ] }, { - "group": "支持", - "icon": "messages-square", + "group": "Analytics", "pages": [ - "zh/integrations/support/overview", - "zh/integrations/support/intercom", - "zh/integrations/support/front" + "zh/analytics/overview", + "zh/analytics/feedback", + "zh/analytics/search" ] }, + "zh/optimize/seo", + "zh/optimize/pdf-exports", { - "group": "隐私", - "icon": "folder-lock", + "group": "集成", "pages": [ - "zh/integrations/privacy/overview", - "zh/integrations/privacy/osano" + { + "group": "Analytics", + "pages": [ + "zh/integrations/analytics/overview", + "zh/integrations/analytics/amplitude", + "zh/integrations/analytics/clearbit", + "zh/integrations/analytics/fathom", + "zh/integrations/analytics/google-analytics", + "zh/integrations/analytics/google-tag-manager", + "zh/integrations/analytics/heap", + "zh/integrations/analytics/hightouch", + "zh/integrations/analytics/hotjar", + "zh/integrations/analytics/koala", + "zh/integrations/analytics/logrocket", + "zh/integrations/analytics/mixpanel", + "zh/integrations/analytics/pirsch", + "zh/integrations/analytics/plausible", + "zh/integrations/analytics/posthog", + "zh/integrations/analytics/segment" + ] + }, + { + "group": "SDK", + "pages": [ + "zh/integrations/sdks/speakeasy", + "zh/integrations/sdks/stainless" + ] + }, + { + "group": "支持", + "pages": [ + "zh/integrations/support/overview", + "zh/integrations/support/intercom", + "zh/integrations/support/front" + ] + }, + { + "group": "隐私", + "pages": [ + "zh/integrations/privacy/overview", + "zh/integrations/privacy/osano" + ] + } ] } ] + } + ] + }, + { + "tab": "指南", + "groups": [ + { + "group": "人工智能", + "icon": "bot", + "pages": [ + "zh/guides/geo", + "zh/guides/claude-code", + "zh/guides/cursor", + "zh/guides/windsurf" + ] + }, + { + "group": "API 文档", + "icon": "file-json", + "pages": [ + "zh/guides/migrating-from-mdx" + ] + }, + { + "group": "Analytics", + "icon": "chart-line", + "pages": [ + "zh/guides/improving-docs" + ] }, { - "group": "版本控制与 CI/CD", + "group": "Git", + "icon": "git-merge", "pages": [ - "zh/settings/github", - "zh/settings/gitlab", - "zh/settings/ci", - "zh/settings/preview-deployments" + "zh/guides/git-concepts", + "zh/guides/branches" ] } ] @@ -1103,10 +1202,14 @@ "groups": [ { "group": "API 参考", - "pages": ["zh/api-reference/introduction"] + "icon": "file-json", + "pages": [ + "zh/api-reference/introduction" + ] }, { "group": "管理员", + "icon": "activity", "pages": [ "zh/api-reference/update/trigger", "zh/api-reference/update/status" @@ -1114,6 +1217,7 @@ }, { "group": "代理", + "icon": "pen-line", "pages": [ "zh/api-reference/agent/create-agent-job", "zh/api-reference/agent/get-agent-job", @@ -1122,6 +1226,7 @@ }, { "group": "AI 助手", + "icon": "bot-message-square", "pages": [ "zh/api-reference/assistant/create-assistant-message", "zh/api-reference/assistant/search" @@ -1134,6 +1239,7 @@ "groups": [ { "group": "更新日志", + "icon": "calendar", "pages": [ "zh/changelog" ] @@ -1249,7 +1355,13 @@ "background": "/images/thumbnail/background.svg" }, "contextual": { - "options": ["copy", "chatgpt", "claude", "cursor", "vscode"] + "options": [ + "copy", + "chatgpt", + "claude", + "cursor", + "vscode" + ] }, "redirects": [ { @@ -1581,4 +1693,4 @@ "publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8" } } -} +} \ No newline at end of file diff --git a/es/ai-native.mdx b/es/ai-native.mdx new file mode 100644 index 000000000..860b34748 --- /dev/null +++ b/es/ai-native.mdx @@ -0,0 +1,60 @@ +--- +title: "Nativo de IA" +description: "Aprende cómo la IA mejora la lectura, la escritura y el descubrimiento de tu documentación" +--- + +Cuando hospedas tu documentación en Mintlify, las funciones de IA integradas ayudan a tus usuarios a encontrar respuestas y a tu equipo a mantener el contenido de forma más eficiente. Tu contenido aporta el contexto para que estas funciones nativas de IA mejoren las experiencias de lectura, escritura y descubrimiento de tu documentación. + +
+ ## Qué hace que tu documentación sea nativa de IA +
+ +
+ ### Lectura +
+ +Además de leer páginas individuales, los usuarios pueden chatear con el [assistant](/es/ai/assistant) en tu documentación para obtener respuestas inmediatas a sus preguntas y enlaces a contenido relevante. El assistant ayuda a guiar a los usuarios por tu producto con información precisa de tu documentación. Integra el assistant en aplicaciones personalizadas con la [API](es/api-reference/assistant/create-assistant-message) para ampliar los lugares desde los que los usuarios pueden acceder a tu documentación. + +
+ ### Redacción +
+ +El [agente](/es/ai/agent) te ayuda a redactar y mantener la documentación. Crea solicitudes de extracción con cambios propuestos basados en tus indicaciones, solicitudes de extracción y hilos de Slack. Añade el agente a tu espacio de trabajo de Slack para que cualquiera de tu equipo pueda ayudar a mantener la documentación conversando con él. O integra el agente en aplicaciones personalizadas a través de la [API](/es/api-reference/agent/create-agent-job). + +Configura herramientas populares como [Cursor](/es/guides/cursor), [Claude Code](/es/guides/claude-code) y [Windsurf](/es/guides/windsurf) para que tomen como referencia el esquema de Mintlify, tu guía de estilo y las mejores prácticas. + +
+ ### Descubrimiento +
+ +Tu sitio se optimiza automáticamente para herramientas de IA y motores de búsqueda, lo que ayuda a los usuarios a descubrir tu documentación. Todas las páginas se envían como Markdown a los agentes de IA en lugar de HTML, lo que permite procesar el contenido más rápido y consumir menos tokens. Además, puedes ver cualquier página en formato Markdown agregando `.md` al final de la URL. + +Mintlify hospeda los archivos `llms.txt` y `llms-full.txt` para tu documentación. Estos archivos estándar del sector ayudan a los LLM a indexar tu documentación y a responder con eficiencia y relevancia a las consultas de los usuarios. + +Tu sitio de documentación también ejecuta un servidor MCP (Model Context Protocol) que permite a los usuarios conectar tu documentación directamente con sus herramientas de IA para obtener información actualizada sobre tu producto, justo donde la necesitan. + +La búsqueda de texto completo y la comprensión semántica ayudan a los usuarios y a las herramientas de IA a encontrar información relevante rápidamente. La búsqueda comprende la intención del usuario en lugar de limitarse a coincidir palabras clave. Y si un usuario se encuentra con un error 404, tu sitio sugiere páginas relacionadas para ayudarle a encontrar lo que busca. No se requiere configuración. + +
+ ## Habilitar funciones de IA +
+ +Selecciona cualquiera de las siguientes tarjetas para obtener más información. + + + + Configura el assistant para buscar en sitios externos o derivar a las personas a tu equipo de soporte si no puede responder sus preguntas. + + + + Agrega el agente a tu espacio de trabajo de Slack o intégralo en aplicaciones personalizadas para que ayude a redactar y actualizar tu documentación. + + + + Agrega un menú a las páginas que permita a los usuarios consultar herramientas de IA, conectarse a tu servidor MCP y copiar páginas como contexto con un clic. + + + + Tu sitio cuenta con un servidor MCP alojado que permite a los usuarios conectar tu documentación directamente con sus herramientas de IA. Informa a tus usuarios sobre tu servidor MCP y cómo conectarse a él. + + \ No newline at end of file diff --git a/es/ai/agent.mdx b/es/ai/agent.mdx index 728675f88..2421dcc5e 100644 --- a/es/ai/agent.mdx +++ b/es/ai/agent.mdx @@ -1,23 +1,22 @@ --- title: "Agent" -description: "El agente te ayuda a redactar y mantener la documentación" -icon: "pen-line" +description: "El agente te ayuda a escribir y mantener la documentación" --- El agente está disponible en los [planes Pro y Custom](https://mintlify.com/pricing?ref=agent) para cualquier persona con acceso a tu dashboard. -El agente crea solicitudes de extracción con cambios propuestos a tu documentación basados en tus indicaciones. Cuando envías una solicitud al agente, este consulta tu documentación, repositorios conectados y mensajes de Slack para generar contenido que siga las mejores prácticas de redacción técnica y se ajuste al esquema de Mintlify. Accede al agente en tu espacio de trabajo de Slack o intégralo en aplicaciones personalizadas con la API. +El agente crea solicitudes de extracción con cambios propuestos para tu documentación a partir de tus indicaciones. Cuando envías una solicitud al agente, este consulta tu documentación, los repositorios conectados y los mensajes de Slack para generar contenido que siga las mejores prácticas de redacción técnica y cumpla con el esquema de Mintlify. Accede al agente desde tu espacio de trabajo de Slack o intégralo en aplicaciones personalizadas con la API. Usa el agente para: -* Redactar contenido nuevo a partir de tus indicaciones, enlaces a solicitudes de extracción o hilos de Slack -* Revisar ejemplos de código obsoletos y referencias de API +* Escribir contenido nuevo a partir de tus indicaciones, enlaces a solicitudes de extracción o hilos de Slack +* Revisar ejemplos de código desactualizados y referencias de API * Buscar y actualizar contenido existente * Responder preguntas sobre tu documentación y temas de redacción técnica -Para empezar, agrega el agente a tu espacio de trabajo de Slack y menciónalo con `@mintlify` en un canal. +Para empezar, añade el agente a tu espacio de trabajo de Slack y menciónalo con `@mintlify` en un canal.
## Agrega el agente a tu espacio de trabajo de Slack diff --git a/es/ai/assistant.mdx b/es/ai/assistant.mdx new file mode 100644 index 000000000..e30a39e0d --- /dev/null +++ b/es/ai/assistant.mdx @@ -0,0 +1,155 @@ +--- +title: "Assistant" +description: "Ayuda a los usuarios a tener éxito con tu producto y a encontrar respuestas más rápido" +--- + + + El assistant se habilita automáticamente en los [planes Pro y Custom](https://mintlify.com/pricing?ref=assistant). + + +
+ ## Acerca del assistant +
+ +El assistant responde preguntas sobre tu documentación mediante búsquedas en lenguaje natural. Está integrado directamente en tu sitio de documentación y ofrece a los usuarios acceso inmediato a ayuda contextual. + +El assistant utiliza RAG agentivo (generación aumentada por recuperación) con llamadas a herramientas, impulsado por Claude Sonnet 4. Cuando los usuarios hacen preguntas, el assistant: + +* **Busca y recupera** contenido relevante de tu documentación para ofrecer respuestas precisas. +* **Cita las fuentes** y proporciona enlaces navegables que llevan a los usuarios directamente a las páginas de referencia. +* **Genera ejemplos de código copiables** para ayudar a los usuarios a implementar soluciones a partir de tu documentación. + +Cada mensaje enviado al assistant cuenta para la cuota de mensajes de tu plan. Si superas tu cuota, los mensajes adicionales generarán cargos por excedente. Puedes establecer límites de gasto o desactivar el assistant si alcanzas tu cuota de mensajes. + +Puedes ver el uso del assistant desde tu dashboard para comprender el comportamiento de los usuarios y la efectividad de la documentación. Exporta y analiza los datos de búsqueda para identificar: + +* Preguntas frecuentes que podrían necesitar mejor cobertura. +* Brechas de contenido donde los usuarios tienen dificultades para encontrar respuestas. +* Temas populares que podrían beneficiarse de contenido adicional. + +
+ ## Configuración del assistant +
+ +El assistant está habilitado de forma predeterminada para los planes Pro y Custom. Puedes gestionar el assistant desde tu [dashboard](https://dashboard.mintlify.com/products/assistant/settings), incluido activarlo o desactivarlo, configurar el manejo de respuestas y establecer un límite de gasto. + +
+ ### Estado del assistant +
+ +Activa o desactiva el assistant para habilitarlo o deshabilitarlo en tu sitio de documentación. + +
+ ### Desvío del assistant +
+ +Permite que el assistant redirija las preguntas sin respuesta a tu equipo de soporte. Proporciona una dirección de correo electrónico que el assistant facilitará a los usuarios que hagan preguntas que no pueda responder. + +
+ ### Buscar sitios +
+ + + La búsqueda del sitio está en beta. Para habilitarla en tu sitio de documentación, [contacta a nuestro equipo de ventas](mailto:gtm@mintlify.com). + + +Configura los sitios que el assistant puede consultar para obtener contexto adicional al responder preguntas. + +* Los sitios deben ser públicamente accesibles. +* No se admiten sitios que requieran JavaScript para cargarse. + +Puedes usar la siguiente sintaxis de filtrado cuando configures sitios externos: + +* **Filtrado a nivel de domain** + * `example.com`: Buscar solo el domain `example.com` + * `docs.example.com`: Buscar solo el subdomain `docs.example.com` + * `*.example.com`: Buscar todos los subdomains de `example.com` +* **Filtrado a nivel de ruta** + * `docs.example.com/api`: Buscar todas las páginas dentro de la subruta `/api` +* **Múltiples patrones** + * Agrega varias entradas para dirigirte a diferentes secciones de los sitios + +
+ ### Límite de gasto +
+ +Define un límite de gasto para controlar qué sucede si llegas a tu cupo de mensajes. De forma predeterminada, el assistant seguirá respondiendo preguntas de los usuarios después de alcanzar tu cupo de mensajes, lo que generará cargos por excedente. + +En la pestaña **Billing** de la página [Assistant Configurations](https://dashboard.mintlify.com/products/assistant/settings), puedes establecer un límite de gasto para los mensajes del assistant más allá de tu cupo. Cuando alcanzas tu límite de gasto, el assistant se desactiva hasta que se restablece tu cupo de mensajes. + +También puedes configurar alertas de uso para recibir un correo electrónico cuando alcances un porcentaje determinado de tu límite de gasto. + +
+ ## Uso del assistant +
+ +Los usuarios pueden acceder al assistant de tres maneras: + +* **Atajo de teclado**: Command + I (Ctrl + I en Windows) +* **Botón del assistant** junto a la barra de búsqueda + Barra de búsqueda y botón del assistant en modo claro. + Barra de búsqueda y botón del assistant en modo oscuro. +* **URL** con `?assistant=open` añadida abrirá el assistant cuando cargue la página. Por ejemplo, [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open). + +Estos métodos abren un panel de chat en el lado derecho de tu documentación. Los usuarios pueden hacer cualquier pregunta y el assistant buscará en tu documentación una respuesta. Si no se encuentra información relevante, el assistant indicará que no puede responder la pregunta. + +
+ ## Hacer que el contenido sea apto para la IA +
+ +Estructura tu documentación para ayudar al assistant a ofrecer respuestas precisas y relevantes. Una organización clara y un contexto completo benefician tanto a los lectores humanos como a la comprensión de la IA. + + + * Usa marcado semántico. + * Escribe encabezados descriptivos para las secciones. + * Crea una jerarquía lógica de la información. + * Mantén un formato consistente en toda tu documentación. + * Incluye metadata completa en el frontmatter de la página. + * Divide los bloques largos de texto en párrafos más cortos. + + + + * Define términos y siglas específicos la primera vez que se mencionen. + * Proporciona suficiente contenido conceptual sobre funciones y procedimientos. + * Incluye ejemplos y casos de uso. + * Añade referencias cruzadas a temas relacionados. + * Agrega [páginas ocultas](/es/organize/hidden-pages) con contexto adicional que los usuarios no necesitan, pero que el assistant puede consultar. + + +
+ ## Exportar y analizar consultas +
+ +Revisa y exporta consultas desde tu dashboard para entender cómo las personas interactúan con tu documentación e identificar oportunidades de mejora. Algunas maneras en que el análisis de consultas puede ayudarte a mejorar tu documentación: + +* Identifica brechas de contenido donde las consultas frecuentes reciben respuestas insuficientes. +* Descubre patrones de comportamiento de los usuarios y necesidades de información comunes a partir de temas y patrones en las consultas. +* Prioriza las páginas de alto tráfico para mejorar su precisión y calidad. + +Puedes explorar las consultas desde tu [dashboard](https://dashboard.mintlify.com/products/assistant), pero para obtener insights más potentes te recomendamos exportar un archivo `CSV` con tus consultas, respuestas y fuentes para analizarlas con tu herramienta de IA preferida. + +1. Ve a la [página del assistant](https://dashboard.mintlify.com/products/assistant) en tu dashboard. +2. Selecciona **Export to CSV**. +3. Analiza los datos exportados con tu herramienta preferida. + + + * Resume los temas más comunes de las consultas. + * Enumera las consultas que no tengan fuentes citadas. + * Encuentra patrones en las interacciones fallidas. + \ No newline at end of file diff --git a/es/ai/contextual-menu.mdx b/es/ai/contextual-menu.mdx index 6f4fa824d..24c9af2c3 100644 --- a/es/ai/contextual-menu.mdx +++ b/es/ai/contextual-menu.mdx @@ -1,13 +1,12 @@ --- title: "Menú contextual" -description: "Añade integraciones de IA con un clic a tu documentación" -icon: "square-menu" +description: "Añade integraciones de IA con un solo clic a tu documentación" --- import { PreviewButton } from "/snippets/previewbutton.jsx" import IconsRequired from "/snippets/es/icons-required.mdx"; -El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios abren el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o iniciar conversaciones en ChatGPT, Claude, Perplexity o una herramienta personalizada de su elección, con su documentación ya cargada como contexto. +El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios abren el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o iniciar conversaciones en ChatGPT, Claude, Perplexity o en una herramienta personalizada de su elección, con su documentación ya cargada como contexto. -Un archivo `llms.txt` es un archivo Markdown de texto plano que contiene: +Un archivo `llms.txt` es un archivo Markdown sin formato que contiene: * **Título del sitio** como encabezado H1. * **Secciones de contenido estructurado** con enlaces y una descripción de cada página de tu documentación. @@ -35,25 +34,23 @@ Un archivo `llms.txt` es un archivo Markdown de texto plano que contiene: - [API](https://example.com/docs/api): Lista de endpoints y uso ``` -Este enfoque estructurado permite que los LLM procesen tu documentación de forma eficiente a un nivel general y localicen contenido relevante para las consultas de los usuarios, mejorando la precisión y la velocidad de las búsquedas de documentación asistidas por IA. +Este enfoque estructurado permite a los LLM procesar tu documentación de forma eficiente a un nivel general y localizar contenido relevante para las consultas de los usuarios, mejorando la precisión y la rapidez de las búsquedas de documentación asistidas por IA.
## llms-full.txt
-El archivo `llms-full.txt` combina todo tu sitio de documentación en un solo archivo como contexto para herramientas de IA y lo indexa el tráfico de LLM. +El archivo `llms-full.txt` reúne todo tu sitio de documentación en un único archivo como contexto para herramientas de IA y lo indexa el tráfico de los LLM. -Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Consulta tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. +Mintlify aloja automáticamente un archivo `llms-full.txt` en la raíz de tu proyecto. Visualiza tu `llms-full.txt` agregando `/llms-full.txt` a la URL de tu sitio de documentación. Abrir el llms-full.txt de este sitio. - -
## Archivos personalizados
-Para añadir un archivo personalizado `llms.txt` o `llms-full.txt`, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Añadir un archivo personalizado sustituirá el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado. +Para agregar un archivo personalizado `llms.txt` o `llms-full.txt`, crea un archivo `llms.txt` o `llms-full.txt` en la raíz de tu proyecto. Agregar un archivo personalizado reemplazará el archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, se volverá a usar el archivo predeterminado. -Tu archivo personalizado `llms.txt` o `llms-full.txt` debe tener el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas. +Tu archivo personalizado `llms.txt` o `llms-full.txt` debe incluir el título del sitio como encabezado H1. El resto del contenido es opcional. Consulta [Format](https://llmstxt.org/#format) en la especificación de `llms.txt` para obtener más información sobre secciones opcionales y buenas prácticas. \ No newline at end of file diff --git a/es/ai/markdown-export.mdx b/es/ai/markdown-export.mdx index 370be9fc6..fce8ad2cd 100644 --- a/es/ai/markdown-export.mdx +++ b/es/ai/markdown-export.mdx @@ -1,12 +1,11 @@ --- -title: "Exportación de Markdown" +title: "Exportación a Markdown" description: "Obtén rápidamente versiones en Markdown de las páginas" -icon: "file-text" --- import { PreviewButton } from "/snippets/previewbutton.jsx" -Markdown ofrece texto estructurado que las herramientas de IA pueden procesar con más eficiencia que HTML, lo que se traduce en respuestas más precisas, tiempos de procesamiento más rápidos y un menor consumo de tokens. +Markdown proporciona texto estructurado que las herramientas de IA pueden procesar de forma más eficiente que HTML, lo que se traduce en respuestas más precisas, tiempos de procesamiento más rápidos y un menor consumo de tokens. Mintlify genera automáticamente versiones en Markdown de las páginas, optimizadas para herramientas de IA e integraciones externas. @@ -15,14 +14,12 @@ Mintlify genera automáticamente versiones en Markdown de las páginas, optimiza ## Extensión de URL .md
-Añade `.md` a la URL de cualquier página para ver su versión en Markdown. - -Abrir esta página en Markdown - +Añade `.md` a la URL de cualquier página para ver una versión en Markdown. +Abrir esta página como Markdown
## Atajo de teclado
-Pulsa Command + C (Ctrl + C en Windows) para copiar una página como Markdown al portapapeles. +Pulsa Command + C (Ctrl + C en Windows) para copiar una página en Markdown al portapapeles. \ No newline at end of file diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx index 9672a51fd..ec8e9c2e8 100644 --- a/es/ai/model-context-protocol.mdx +++ b/es/ai/model-context-protocol.mdx @@ -1,7 +1,6 @@ --- title: "Model Context Protocol" -description: "Permite que los usuarios accedan a tu documentación y a tus APIs desde sus herramientas de IA favoritas" -icon: "audio-waveform" +description: "Permite que los usuarios accedan a tu documentación y API a través de sus herramientas de IA favoritas" keywords: ["mcp"] --- diff --git a/es/ai/slack-app.mdx b/es/ai/slack-app.mdx index 47c583b2b..c29e0bfb6 100644 --- a/es/ai/slack-app.mdx +++ b/es/ai/slack-app.mdx @@ -1,16 +1,15 @@ --- -title: "Slack app" -description: "Agrega un bot que busca en tu documentación para responder preguntas en tu espacio de trabajo de Slack" -icon: "slack" +title: "Aplicación de Slack" +description: "Añade un bot que busca en tu documentación para responder preguntas en tu espacio de trabajo de Slack" --- - La aplicación de Slack está disponible para [planes Pro y Custom](https://mintlify.com/pricing?ref=slack-app). + La aplicación de Slack está disponible para los [planes Pro y Custom](https://mintlify.com/pricing?ref=slack-app). -La aplicación de Slack agrega un bot a tu espacio de trabajo que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, @menciones y a cualquier pregunta en un canal llamado específicamente `#ask-ai`. El nombre del bot es `@yourprojectname-assistant`. Por ejemplo, si el nombre de tu proyecto es Mintlify, el bot se llamará `@mintlify-assistant`. +La aplicación de Slack añade un bot a tu espacio de trabajo que puede buscar en tu documentación y responder las preguntas de los usuarios. El bot responde a mensajes directos, @menciones y a cualquier pregunta en un canal llamado específicamente `#ask-ai`. El nombre del bot es `@yourprojectname-assistant`. Así, si el nombre de tu proyecto es Mintlify, el nombre del bot será `@mintlify-assistant`. -La aplicación de Slack puede generar costos: ya sea consumiendo tus créditos del Asistente de IA o generando cargos por excedentes. +La aplicación de Slack puede generar costos: ya sea consumiendo tus créditos del Asistente de IA o incurriendo en cargos por excedente.
## Configura la app de Slack diff --git a/es/api-playground/adding-sdk-examples.mdx b/es/api-playground/adding-sdk-examples.mdx new file mode 100644 index 000000000..2e84bb0c9 --- /dev/null +++ b/es/api-playground/adding-sdk-examples.mdx @@ -0,0 +1,48 @@ +--- +title: "Agregar ejemplos de SDK" +description: "Muestra fragmentos de código específicos por lenguaje junto a tus endpoints de API para mostrar a los desarrolladores cómo usar tus SDK" +--- + +Si tus usuarios interactúan con tu API mediante un SDK en lugar de hacerlo directamente a través de una solicitud de red, puedes usar la extensión `x-codeSamples` para agregar fragmentos de código a tu documento de OpenAPI y mostrarlos en tus páginas de OpenAPI. + +Esta propiedad se puede agregar a cualquier método de solicitud y tiene el siguiente esquema. + + + El lenguaje del fragmento de código. + + + + La etiqueta del ejemplo. Es útil cuando se ofrecen varios ejemplos para un mismo endpoint. + + + + El código fuente del ejemplo. + + +Aquí tienes un ejemplo de fragmentos de código para una aplicación de seguimiento de plantas, que incluye una herramienta de Bash en la CLI y un SDK de JavaScript. + +```yaml +paths: + /plants: + get: + # ... + x-codeSamples: + - lang: bash + label: Listar todas las plantas sin regar + source: | + planter list -u + - lang: javascript + label: Listar todas las plantas sin regar + source: | + const planter = require('planter'); + planter.list({ unwatered: true }); + - lang: bash + label: Listar todas las plantas en maceta + source: | + planter list -p + - lang: javascript + label: Listar todas las plantas en maceta + source: | + const planter = require('planter'); + planter.list({ potted: true }); +``` diff --git a/es/api-playground/complex-data-types.mdx b/es/api-playground/complex-data-types.mdx new file mode 100644 index 000000000..1c5bccafd --- /dev/null +++ b/es/api-playground/complex-data-types.mdx @@ -0,0 +1,104 @@ +--- +title: "Tipos de datos complejos" +description: "Describe APIs con esquemas flexibles, propiedades opcionales y múltiples formatos de datos con las palabras clave `oneOf`, `anyOf` y `allOf`" +--- + +Cuando tu API admite múltiples formatos de datos, tiene campos condicionales o usa patrones de herencia, las palabras clave de composición de esquemas de OpenAPI te ayudan a documentar estas estructuras flexibles. Con `oneOf`, `anyOf` y `allOf`, puedes describir APIs que aceptan distintos tipos de entrada o combinan múltiples esquemas en modelos de datos integrales. + +
+ ## Palabras clave `oneOf`, `anyOf`, `allOf` +
+ +Para tipos de datos complejos, OpenAPI proporciona palabras clave para combinar esquemas: + +- `allOf`: Combina varios esquemas (como fusionar objetos o extender un esquema base). Funciona como un operador `and`. +- `anyOf`: Acepta datos que coincidan con cualquiera de los esquemas proporcionados. Funciona como un operador `or`. +- `oneOf`: Acepta datos que coincidan exactamente con uno de los esquemas proporcionados. Funciona como un operador `exclusive-or`. + +Mintlify trata `oneOf` y `anyOf` de forma idéntica, ya que la diferencia práctica rara vez afecta el uso de la API. + +Para obtener especificaciones detalladas de estas palabras clave, consulta la [documentación de OpenAPI](https://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/). + +La palabra clave `not` no es compatible actualmente. + +
+ ### Combinando esquemas con `allOf` +
+ +Cuando usas `allOf`, Mintlify realiza un preprocesamiento de tu documento de OpenAPI para mostrar combinaciones complejas de forma legible. Por ejemplo, cuando combinas dos esquemas de objeto con `allOf`, Mintlify unifica las propiedades de ambos en un solo objeto. Esto resulta especialmente útil al aprovechar los [componentes](https://swagger.io/docs/specification/components/) reutilizables de OpenAPI. + +```yaml +org_with_users: + allOf: + - $ref: '#/components/schemas/Org' + - type: object + properties: + users: + type: array + description: Una matriz que contiene todos los usuarios de la organización +# ... +components: + schemas: + Org: + type: object + properties: + id: + type: string + description: El ID de la organización +``` + + + + + El ID de la organización + + + + Una matriz que contiene a todos los usuarios de la organización + + + + + +
+ ### Proporcionar opciones con `oneOf` y `anyOf` +
+ +Cuando uses `oneOf` o `anyOf`, las opciones se muestran en un contenedor con pestañas. Especifica un campo `title` en cada subschema para poner nombre a tus opciones. Por ejemplo, así podrías mostrar dos tipos distintos de direcciones de entrega: + +```yaml +delivery_address: + oneOf: + - title: StreetAddress + type: object + properties: + address_line_1: + type: string + description: La dirección postal del destinatario + # ... + - title: POBox + type: object + properties: + box_number: + type: string + description: El número del apartado de correos + # ... +``` + + +
+ + + + La dirección de la residencia + + + + + + El número del apartado postal + + + +
+
diff --git a/es/api-playground/managing-page-visibility.mdx b/es/api-playground/managing-page-visibility.mdx new file mode 100644 index 000000000..8204b1dda --- /dev/null +++ b/es/api-playground/managing-page-visibility.mdx @@ -0,0 +1,90 @@ +--- +title: "Administrar la visibilidad de las páginas" +description: "Controla qué endpoints de tu especificación de OpenAPI aparecen en la navigation de tu documentación" +--- + +Puedes controlar qué operaciones de OpenAPI se publican como páginas de documentación y su visibilidad en la navigation. Esto es útil para endpoints de uso interno, operaciones en desuso, funciones beta o endpoints que deberían ser accesibles mediante una URL directa pero no detectables a través de la navigation del sitio. + +Si tus páginas se generan automáticamente a partir de un documento de OpenAPI, puedes gestionar la visibilidad de las páginas con las extensiones `x-hidden` y `x-excluded`. + +
+ ## `x-hidden` +
+ +La extensión `x-hidden` crea una página para un endpoint, pero la oculta de la navigation. La página solo es accesible accediendo directamente a su URL. + +Los casos de uso comunes de `x-hidden` son: + +- Endpoints que quieres documentar, pero no destacar. +- Páginas a las que enlazarás desde otro contenido. +- Endpoints para usuarios específicos. + +
+ ## `x-excluded` +
+ +La extensión `x-excluded` excluye por completo un endpoint de tu documentación. + +Algunos casos de uso comunes de `x-excluded` son: + +- Endpoints de uso interno. +- Endpoints en desuso que no deseas documentar. +- Funciones beta que aún no están listas para la documentación pública. + +
+ ## Implementación +
+ +Añade la extensión `x-hidden` o `x-excluded` bajo el método HTTP en tu especificación de OpenAPI. + +Aquí tienes ejemplos de cómo usar cada propiedad en un documento de esquema de OpenAPI para un endpoint y una ruta de webhook. + +```json {11, 19} +"paths": { + "/plants": { + "get": { + "description": "Devuelve todas las plantas de la tienda", + "parameters": { /*...*/ }, + "responses": { /*...*/ } + } + }, + "/hidden_plants": { + "get": { + "x-hidden": true, + "description": "Devuelve todas las plantas algo secretas de la tienda", + "parameters": { /*...*/ }, + "responses": { /*...*/ } + } + }, + "/secret_plants": { + "get": { + "x-excluded": true, + "description": "Devuelve todas las plantas ultra secretas de la tienda (¡no publiques este endpoint!)", + "parameters": { /*...*/ }, + "responses": { /*...*/ } + } + } +}, +``` + +```json {9, 15} +"webhooks": { + "/plants_hook": { + "post": { + "description": "Webhook para información sobre una nueva planta añadida a la tienda", + } + }, + "/hidden_plants_hook": { + "post": { + "x-hidden": true, + "description": "Webhook para información algo secreta sobre una nueva planta añadida a la tienda" + } + }, + "/secret_plants_hook": { + "post": { + "x-excluded": true, + "description": "Webhook para información ultra secreta sobre una nueva planta añadida a la tienda (¡no publiques este endpoint!)" + } + } +} +``` diff --git a/es/api-playground/mdx/configuration.mdx b/es/api-playground/mdx/configuration.mdx index 4148cca17..50460cbc8 100644 --- a/es/api-playground/mdx/configuration.mdx +++ b/es/api-playground/mdx/configuration.mdx @@ -1,15 +1,15 @@ --- title: 'Configuración de MDX' -description: 'Genera páginas de documentación para tus endpoints de API usando `MDX`' +description: 'Genera páginas de documentación para tus endpoints de la API usando `MDX`' --- -Puedes definir manualmente endpoints de API en archivos `MDX` individuales en lugar de usar una especificación OpenAPI. Este método ofrece flexibilidad para contenido personalizado, pero recomendamos generar la documentación de la API a partir de un archivo de especificación OpenAPI para la mayoría de los proyectos, ya que es más fácil de mantener y más completo en funcionalidades. Aun así, crear páginas `MDX` para una API puede ser útil para documentar APIs pequeñas o para hacer prototipos. +Puedes definir manualmente endpoints de la API en archivos `MDX` individuales en lugar de usar una especificación de OpenAPI. Este método ofrece flexibilidad para contenido personalizado, pero recomendamos generar la documentación de la API a partir de un archivo de especificación de OpenAPI para la mayoría de los proyectos porque es más fácil de mantener y más completo. No obstante, crear páginas `MDX` para una API puede ser útil para documentar APIs pequeñas o para prototipos. -Para generar páginas para endpoints de API usando `MDX`, configura tu API en `docs.json`, crea archivos `MDX` individuales para cada endpoint y usa componentes como `` para definir parámetros. A partir de estas definiciones, Mintlify genera áreas de pruebas de la API interactivas, ejemplos de solicitudes y ejemplos de respuestas. +Para generar páginas de endpoints de la API usando `MDX`, configura los ajustes de tu API en `docs.json`, crea archivos `MDX` individuales para cada endpoint y usa componentes como `` para definir parámetros. A partir de estas definiciones, Mintlify genera áreas de pruebas de la API interactivas, ejemplos de solicitudes y ejemplos de respuestas. - En tu archivo `docs.json`, define tu URL base y el método de autenticación: + En tu archivo `docs.json`, define la URL base y el método de autenticación: ```json "api": { @@ -23,7 +23,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d } ``` - Si deseas ocultar el área de pruebas de la API, usa el campo `display`. No necesitas incluir un método de autenticación si ocultas el área de pruebas. + Si quieres ocultar el área de pruebas de la API, usa el campo `display`. No necesitas incluir un método de autenticación si ocultas el área de pruebas. ```json "api": { @@ -33,11 +33,11 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d } ``` - Consulta la lista completa de configuraciones de la API en [Settings](/es/settings#api-configurations). + Consulta la lista completa de configuraciones de la API en [Settings](/es/organize/settings#api-configurations). - Cada endpoint de la API debe tener un archivo `MDX` correspondiente. En la parte superior de cada archivo, define `title` y `api`: + Cada página de endpoint de la API debe tener un archivo `MDX` correspondiente. En la parte superior de cada archivo, define `title` y `api`: ```mdx --- @@ -46,7 +46,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d --- ``` - Puedes especificar parámetros de ruta agregando el nombre del parámetro en la ruta, entre `{}`: + Puedes especificar parámetros de ruta añadiendo el nombre del parámetro a la ruta, encerrado entre `{}`: ```bash https://api.example.com/v1/endpoint/{userId} @@ -56,7 +56,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d Si tienes un campo `server` configurado en `docs.json`, puedes usar rutas relativas como `/v1/endpoint`. - Puedes sustituir el modo de visualización definido globalmente para el área de pruebas de la API en una página agregando `playground` al frontmatter: + Puedes reemplazar el modo de visualización definido globalmente para el área de pruebas de la API en una página añadiendo `playground` al frontmatter: ```mdx --- @@ -72,7 +72,7 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d - Agrega las páginas de tus endpoints a la barra lateral añadiendo las rutas en el campo `navigation` de tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/navigation). + Agrega las páginas de tus endpoints a la barra lateral añadiendo las rutas al campo `navigation` en tu `docs.json`. Obtén más información sobre cómo estructurar tu documentación en [Navigation](/es/organize/navigation). @@ -80,12 +80,12 @@ Para generar páginas para endpoints de API usando `MDX`, configura tu API en `d ## Habilitar la autenticación
-Puedes añadir un método de autenticación en tu `docs.json` para habilitarla globalmente en todas las páginas, o configurarlo de forma individual por página. +Puedes añadir un método de autenticación a tu `docs.json` para habilitarla globalmente en todas las páginas, o configurarlo por página. -El método de autenticación definido en una página reemplazará el método global si ambos están configurados. +El método de autenticación de una página tendrá prioridad sobre el método global si ambos están configurados.
- ### Token de portador (Bearer) + ### Token de portador
@@ -101,7 +101,7 @@ El método de autenticación definido en una página reemplazará el método glo ```mdx Page Metadata --- - title: "Your page title" + title: "El título de tu página" authMethod: "bearer" --- ``` @@ -124,7 +124,7 @@ El método de autenticación definido en una página reemplazará el método glo ```mdx Page Metadata --- - title: "Your page title" + title: "Título de la página" authMethod: "basic" --- ``` @@ -148,7 +148,7 @@ El método de autenticación definido en una página reemplazará el método glo ```mdx Page Metadata --- - title: "Your page title" + title: "Título de tu página" authMethod: "key" --- ``` @@ -158,7 +158,7 @@ El método de autenticación definido en una página reemplazará el método glo ### Ninguno -El método de autenticación `none` es útil para desactivar la autenticación en un endpoint específico después de establecer un valor predeterminado en docs.json. +El método de Autenticación `none` es útil para desactivar la autenticación en un endpoint específico después de definir un valor predeterminado en docs.json. ```mdx Page Metadata @@ -167,4 +167,4 @@ El método de autenticación `none` es útil para desactivar la autenticación e authMethod: "none" --- ``` - + \ No newline at end of file diff --git a/es/api-playground/multiple-responses.mdx b/es/api-playground/multiple-responses.mdx new file mode 100644 index 000000000..9cacbbe46 --- /dev/null +++ b/es/api-playground/multiple-responses.mdx @@ -0,0 +1,31 @@ +--- +title: "Respuestas múltiples" +description: "Muestra variaciones de respuesta para el mismo endpoint" +--- + +Si tu API devuelve distintas respuestas según los parámetros de entrada, el contexto del usuario u otras condiciones de la solicitud, puedes documentar varios ejemplos de respuesta con la propiedad `examples`. + +Esta propiedad se puede añadir a cualquier respuesta y tiene el siguiente esquema. + +```yaml +responses: + "200": + description: Respuesta exitosa + content: + application/json: + schema: + $ref: "#/components/schemas/YourResponseSchema" + examples: + us: + summary: Respuesta para Estados Unidos + value: + countryCode: "US" + currencyCode: "USD" + taxRate: 0.0825 + gb: + summary: Respuesta para Reino Unido + value: + countryCode: "GB" + currencyCode: "GBP" + taxRate: 0.20 +``` diff --git a/es/api-playground/openapi-setup.mdx b/es/api-playground/openapi-setup.mdx index 2891ac62a..69836e65f 100644 --- a/es/api-playground/openapi-setup.mdx +++ b/es/api-playground/openapi-setup.mdx @@ -1,10 +1,9 @@ --- title: "Configuración de OpenAPI" -description: "Haz referencia a endpoints de OpenAPI en tus páginas de documentación" -icon: "file-json" +description: "Referencia endpoints de OpenAPI en tus páginas de documentación" --- -OpenAPI es una especificación para describir APIs. Mintlify admite documentos de OpenAPI 3.0+ para generar documentación de API interactiva y mantenerla actualizada. +OpenAPI es una especificación para describir API. Mintlify es compatible con documentos de OpenAPI 3.0+ para generar documentación de API interactiva y mantenerla actualizada.
## Agrega un archivo de especificación OpenAPI @@ -280,27 +279,27 @@ Para obtener más información, consulta [Model Context Protocol](/es/ai/model-c ## Rellenar automáticamente páginas de API
-Agrega un campo `openapi` a cualquier elemento de `navigation` en tu `docs.json` para generar automáticamente páginas para endpoints de OpenAPI. Puedes controlar dónde aparecen estas páginas en tu estructura de navegación, ya sea como secciones de API dedicadas o junto con otras páginas. +Agrega el campo `openapi` a cualquier elemento de `navigation` en tu `docs.json` para generar automáticamente páginas para endpoints de OpenAPI. Puedes controlar dónde aparecen estas páginas en tu estructura de navegación, ya sea como secciones de API dedicadas o junto con otras páginas. -El campo `openapi` acepta una ruta de archivo en tu repositorio de documentación o una URL a un documento de OpenAPI hospedado. +El campo `openapi` acepta una ruta de archivo en tu repositorio de documentación o una URL a un documento de OpenAPI alojado. Las páginas de endpoints generadas tienen estos valores de metadata predeterminados: * `title`: El campo `summary` de la operación, si está presente. Si no hay `summary`, el título se genera a partir del método HTTP y el endpoint. * `description`: El campo `description` de la operación, si está presente. -* `version`: El valor de `version` del ancla o Tab principal, si está presente. -* `deprecated`: El campo `deprecated` de la operación. Si es `true`, aparecerá una etiqueta en desuso junto al título del endpoint en la navegación lateral y en la página del endpoint. +* `version`: El valor de `version` del ancla o Tab padre, si está presente. +* `deprecated`: El campo `deprecated` de la operación. Si es `true`, aparecerá una etiqueta de en desuso junto al título del endpoint en la navegación lateral y en la página del endpoint. - Para excluir endpoints específicos de tus páginas de API generadas automáticamente, agrega la - propiedad [x-hidden](/es/api-playground/customization/managing-page-visibility#x-hidden) + Para excluir endpoints específicos de tus páginas de API generadas automáticamente, agrega la propiedad + [x-hidden](/es/api-playground/managing-page-visibility#x-hidden) a la operación en tu especificación de OpenAPI. Hay dos enfoques para agregar páginas de endpoints a tu documentación: -1. **Secciones de API dedicadas**: Haz referencia a especificaciones de OpenAPI en elementos de `navigation` para secciones de API dedicadas. -2. **Endpoints selectivos**: Haz referencia a endpoints específicos en tu navegación junto con otras páginas. +1. **Secciones de API dedicadas**: Hace referencia a especificaciones de OpenAPI en elementos de `navigation` para secciones de API dedicadas. +2. **Endpoints selectivos**: Haz referencia a endpoints específicos en tu `navigation` junto con otras páginas.
### Secciones de API dedicadas diff --git a/es/api-playground/overview.mdx b/es/api-playground/overview.mdx index c5d113d87..c7d1ceed0 100644 --- a/es/api-playground/overview.mdx +++ b/es/api-playground/overview.mdx @@ -1,7 +1,6 @@ --- -title: "Playground" -description: "Permite que las personas interactúen con tu API" -icon: "play" +title: "Zona de pruebas" +description: "Permite que los usuarios interactúen con tu API" ---
diff --git a/es/api-playground/troubleshooting.mdx b/es/api-playground/troubleshooting.mdx index ec3aaf3e4..b23b954a7 100644 --- a/es/api-playground/troubleshooting.mdx +++ b/es/api-playground/troubleshooting.mdx @@ -1,18 +1,18 @@ --- title: "Solución de problemas" -description: "Problemas comunes con las referencias de la API" -icon: "message-square-warning" +description: "Problemas comunes con las referencias de API" --- -Si tus páginas de la API no se muestran correctamente, revisa estos problemas de configuración comunes: +Si tus páginas de API no se muestran correctamente, revisa estos problemas de configuración comunes: - En este escenario, es probable que Mintlify no pueda encontrar tu documento de OpenAPI o que tu documento de OpenAPI sea inválido. + En este caso, es probable que Mintlify no pueda encontrar tu documento de OpenAPI + o que tu documento de OpenAPI no sea válido. - Ejecutar `mint dev` localmente debería revelar algunos de estos problemas. + Ejecutar `mint dev` de forma local debería revelar algunos de estos problemas. - Para verificar que tu documento de OpenAPI pasará la validación: + Para comprobar que tu documento de OpenAPI supere la validación: 1. Visita [este validador](https://editor.swagger.io/) 2. Cambia a la pestaña "Validate text" @@ -20,10 +20,10 @@ Si tus páginas de la API no se muestran correctamente, revisa estos problemas d 4. Haz clic en "Validate it!" Si el cuadro de texto que aparece abajo tiene un borde verde, tu documento ha pasado la validación. - Este es exactamente el paquete de validación que utiliza Mintlify para validar documentos de OpenAPI, así que si tu documento - pasa la validación aquí, hay muchas probabilidades de que el problema esté en otra parte. + Este es exactamente el mismo paquete de validación que usa Mintlify para validar documentos de OpenAPI, así que si tu documento + pasa la validación aquí, es muy probable que el problema esté en otra parte. - Además, Mintlify no admite OpenAPI 2.0. Si tu documento usa esta versión de la especificación, + Además, Mintlify no es compatible con OpenAPI 2.0. Si tu documento usa esta versión de la especificación, podrías encontrarte con este problema. Puedes convertir tu documento en [editor.swagger.io](https://editor.swagger.io/) (en Edit > Convert to OpenAPI 3): @@ -32,9 +32,9 @@ Si tus páginas de la API no se muestran correctamente, revisa estos problemas d - Esto suele deberse a que el campo `openapi` está mal escrito en la metadata de la página. Asegúrate de que el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI. + Esto suele deberse a un campo `openapi` mal escrito en la metadata de la página. Asegúrate de que el método HTTP y la ruta coincidan exactamente con el método HTTP y la ruta del documento de OpenAPI. - Aquí tienes un ejemplo de cómo podrían salir mal las cosas: + Aquí tienes un ejemplo de cómo puede salir mal: ```mdx get-user.mdx --- @@ -48,9 +48,9 @@ Si tus páginas de la API no se muestran correctamente, revisa estos problemas d get: ... ``` - Observa que la ruta en el campo `openapi` tiene una barra final, mientras que la ruta en el documento de OpenAPI no la tiene. + Observa que la ruta en el campo `openapi` tiene una barra al final, mientras que la ruta en el documento de OpenAPI no la tiene. - Otro problema común es un nombre de archivo mal escrito. Si estás especificando un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre de archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI, `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así: + Otro problema común es un nombre de archivo mal escrito. Si especificas un documento de OpenAPI en particular en el campo `openapi`, asegúrate de que el nombre del archivo sea correcto. Por ejemplo, si tienes dos documentos de OpenAPI, `openapi/v1.json` y `openapi/v2.json`, tu metadata podría verse así: ```mdx api-reference/v1/users/get-user.mdx --- @@ -60,15 +60,15 @@ Si tus páginas de la API no se muestran correctamente, revisa estos problemas d - Si tienes un domain personalizado configurado, esto podría deberse a tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir solo solicitudes `GET`, entonces todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`. + Si tienes un domain personalizado configurado, esto podría deberse a tu proxy inverso. De forma predeterminada, las solicitudes realizadas a través del área de pruebas de la API comienzan con una solicitud `POST` a la ruta `/_mintlify/api/request` en el sitio de documentación. Si tu proxy inverso está configurado para permitir únicamente solicitudes `GET`, todas estas solicitudes fallarán. Para solucionarlo, configura tu proxy inverso para permitir solicitudes `POST` a la ruta `/_mintlify/api/request`. - Como alternativa, si tu proxy inverso te impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con el ajuste `api.playground.proxy` en el `docs.json`, como se describe en la [documentación de configuración](/es/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes llegarán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy. + Como alternativa, si tu proxy inverso impide aceptar solicitudes `POST`, puedes configurar Mintlify para enviar solicitudes directamente a tu backend con la opción `api.playground.proxy` en `docs.json`, como se describe en la [documentación de configuración](/es/organize/settings#param-proxy). Al usar esta configuración, deberás configurar CORS en tu servidor, ya que las solicitudes vendrán directamente desde los navegadores de los usuarios en lugar de pasar por tu proxy. - Si estás utilizando una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes: + Si estás usando una configuración de navigation de OpenAPI, pero las páginas no se generan, revisa estos problemas comunes: - 1. **Falta la especificación predeterminada de OpenAPI**: Asegúrate de tener un campo `openapi` establecido para el elemento de navigation: + 1. **Falta la especificación predeterminada de OpenAPI**: Asegúrate de tener definido un campo `openapi` para el elemento de navigation: ```json {5} "navigation": { @@ -85,22 +85,22 @@ Si tus páginas de la API no se muestran correctamente, revisa estos problemas d } ``` - 2. **Herencia de la especificación OpenAPI**: Si usas navigation anidada, asegúrate de que los grupos secundarios hereden la especificación de OpenAPI correcta o definan la suya propia. + 2. **Herencia de la especificación OpenAPI**: Si usas navegación anidada, asegúrate de que los grupos hijos hereden la especificación OpenAPI correcta o definan la suya propia. - 3. **Problemas de validación**: Usa `mint openapi-check ` para verificar que tu documento de OpenAPI sea válido. + 3. **Problemas de validación**: Usa `mint openapi-check ` para verificar que tu documento OpenAPI sea válido. - + 1. **Operaciones ocultas**: Las operaciones marcadas con `x-hidden: true` en tu especificación de OpenAPI no aparecerán en la navigation generada automáticamente. 2. **Operaciones no válidas**: Las operaciones con errores de validación en la especificación de OpenAPI pueden omitirse. Revisa tu documento de OpenAPI para detectar errores de sintaxis. - 3. **Inclusión manual vs. automática**: Si haces referencia a endpoints desde una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se agregarán otras páginas automáticamente. Esto incluye las operaciones referenciadas en elementos secundarios de la navigation. + 3. **Inclusión manual vs. automática**: Si haces referencia a endpoints desde una especificación de OpenAPI, solo las operaciones referenciadas explícitamente aparecerán en la navigation. No se añadirá ninguna otra página automáticamente. Esto incluye las operaciones referenciadas en elementos secundarios de la navigation. Al combinar operaciones de OpenAPI con páginas de documentación regulares en navigation: - 1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también "GET /users" en tu navigation. Si necesitas tener un archivo que comparta nombre con una operación, usa la extensión `x-mint` para el endpoint para que el href apunte a una ubicación diferente. - 2. **Resolución de rutas**: Las entradas de navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivo. Asegúrate de que tus archivos `MDX` existan en las ubicaciones previstas. - 3. **Diferenciación entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue entre mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation. + 1. **Conflictos de archivos**: No puedes tener a la vez un archivo `MDX` y una entrada en navigation para la misma operación. Por ejemplo, si tienes `get-users.mdx`, no incluyas también "GET /users" en tu navigation. Si necesitas un archivo que comparta nombre con una operación, usa la extensión `x-mint` del endpoint para que el href apunte a otra ubicación. + 2. **Resolución de rutas**: Las entradas de navigation que no coincidan con operaciones de OpenAPI se tratarán como rutas de archivos. Asegúrate de que tus archivos `MDX` existan en las ubicaciones previstas. + 3. **Distinción entre mayúsculas y minúsculas**: La coincidencia de operaciones de OpenAPI distingue mayúsculas y minúsculas. Asegúrate de que los métodos HTTP estén en mayúsculas en las entradas de navigation. \ No newline at end of file diff --git a/es/api-reference/introduction.mdx b/es/api-reference/introduction.mdx index 567cc03be..8746be6c9 100644 --- a/es/api-reference/introduction.mdx +++ b/es/api-reference/introduction.mdx @@ -1,10 +1,9 @@ --- title: "Introducción" -description: "Activar actualizaciones, integrar el Asistente de IA y más" -icon: "book-open" +description: "Activar actualizaciones, integrar el assistant de IA y más" --- -La API REST de Mintlify te permite interactuar de forma programática con tu documentación, activar actualizaciones e integrar experiencias de chat con IA. +La API REST de Mintlify te permite interactuar con tu documentación de forma programática, activar actualizaciones e integrar experiencias de chat con IA.
## Endpoints diff --git a/es/authentication-personalization/overview.mdx b/es/authentication-personalization/overview.mdx index caa72821d..f91df4c5e 100644 --- a/es/authentication-personalization/overview.mdx +++ b/es/authentication-personalization/overview.mdx @@ -1,7 +1,6 @@ --- title: "Overview" -description: "Controla quién puede ver tu documentación y personaliza su experiencia" -icon: "badge-info" +description: "Controla quién ve tu documentación y personaliza su experiencia" keywords: ["auth"] --- @@ -13,9 +12,9 @@ keywords: ["auth"] Elige entre tres enfoques para gestionar el acceso y personalizar tu documentación según la información del usuario y tus necesidades de seguridad: -* **Autenticación completa**: Privacidad total de todo el contenido con personalización completa. -* **Autenticación parcial**: Control de acceso por página con personalización completa. -* **Personalización**: Personalización del contenido sin **garantías de seguridad**. Todo el contenido sigue siendo de acceso público. +* **Autenticación completa**: Privacidad total para todo el contenido, con personalización completa. +* **Autenticación parcial**: Control de acceso página por página, con personalización completa. +* **Personalización**: Personalización de contenido sin **garantías de seguridad**. Todo el contenido sigue siendo de acceso público.
### Ejemplos de casos de uso @@ -70,4 +69,4 @@ Elige el método que mejor se adapte a tu infraestructura actual y a tus requisi ## Personalización del contenido
-Los tres enfoques admiten funciones de personalización del contenido, como contenido MDX dinámico, el rellenado previo de la API key y controles de visibilidad de páginas. Para obtener instrucciones de implementación detalladas, consulta [Configuración de personalización](/es/authentication-personalization/personalization-setup). \ No newline at end of file +Los tres enfoques admiten funciones de personalización del contenido, como contenido MDX dinámico, autocompletado de API key y controles de visibilidad de páginas. Para obtener instrucciones de implementación detalladas, consulta [Configuración de personalización](/es/deploy/personalization-setup). \ No newline at end of file diff --git a/es/changelog.mdx b/es/changelog.mdx index 2c9b4b261..69c36a1e4 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -154,57 +154,57 @@ noindex: true * Se mejoró la confiabilidad del assistant con soporte de LLM de respaldo, mejor manejo de errores por límites de tasa y una herramienta de búsqueda más robusta - - ## Optimizaciones de rendimiento y compilación + + ## Optimizaciones de rendimiento y de compilación - * La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos serverless de NextJS sin caché, mejorando el tiempo hasta el primer byte para páginas sin caché. - * El hash basado en contenido evita la retranspilación cuando el MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) - * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos adicionales y paralelización de consultas en nuestro backend - * Se redujo el tamaño de la página eliminando datos duplicados de `navigation` en la carga útil `rsc` de cada página; las mejoras de rendimiento son más notables con un alto número de páginas o estructuras de navegación complejas - * Un prefetching más agresivo permite cargas de página casi instantáneas con mayor frecuencia + * La transpilación de MDX ahora ocurre en el momento de la implementación en lugar de en cada carga de página en entornos sin caché de NextJS serverless, mejorando el tiempo hasta el primer byte para páginas no cacheadas. + * El hashing basado en contenido evita retranspilar cuando MDX no ha cambiado, reduciendo los tiempos del flujo de actualización en ~50% para clientes con un gran número de páginas (las implementaciones de más de 5 minutos deberían reducirse aproximadamente a la mitad) + * La visualización de implementaciones de vista previa en el dashboard ahora es más rápida gracias a índices de base de datos añadidos y a la paralelización de consultas en nuestro backend + * Se redujo el tamaño de la página al eliminar datos duplicados de `navigation` en la carga útil `rsc` de cada página; las mejoras de rendimiento son más notables con un alto número de páginas o estructuras de navegación complejas + * Un prefetching más agresivo permite cargas de página instantáneas con mayor frecuencia - ## Área de pruebas de la API y mejoras en OpenAPI + ## Mejoras del área de pruebas de la API y de OpenAPI * La conversión de OpenAPI a MCP se trasladó al backend, lo que permite que los servidores MCP alojados contengan herramientas (pronto habrá documentación y opciones de configuración más claras) - * Se añadió compatibilidad con Ruby al área de pruebas de la API - * Agregamos una función con la que ahora puedes [especificar páginas de la API usando solo tu docs.json](/es/api-playground/openapi-setup#auto-populate-api-pages) sin crear nuevos archivos mdx. - * Compatibilidad con [páginas `webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI - * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlace de anclaje de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores + * Se añadió compatibilidad con Ruby en el área de pruebas de la API + * Agregamos una función para que ahora puedas [especificar páginas de API usando solo tu docs.json](/es/api-playground/openapi-setup#auto-populate-api-pages) sin crear nuevos archivos mdx. + * Compatibilidad con [páginas de `webhook`](/es/api-playground/openapi-setup#webhooks) en la navegación de la documentación a partir de especificaciones OpenAPI + * Se optimizó el contexto del modelo de IA eliminando las especificaciones de enlaces de anclaje de los enlaces de Markdown al navegar a Anthropic, OpenAI u otros proveedores ## Mejoras del editor web - * La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera en lugar de requerir presionar la tecla Enter - * Se corrigió la navegación por branch en la que cambiar la URL a una branch específica redirigía a la última branch activa en lugar del destino previsto - * Codificación adecuada de URL para títulos de branch que contienen `/` para evitar roturas de la navegación - * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard de monorepos que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos + * La creación y el cambio de nombre de archivos ahora guardan los cambios al hacer clic fuera, en lugar de requerir presionar la tecla Enter + * Se corrigió la navegación de branch donde cambiar la URL a un branch específico redirigía al último branch activo en lugar del destino previsto + * Se codifican correctamente en la URL los títulos de branch que contienen `/` para evitar rupturas de navegación + * Se corrigió el atajo de enlace `Ctrl+K` en el Editor del dashboard para monorepos, que estaba anteponiendo la ruta del repositorio de documentación y creando enlaces rotos ## Analytics e integraciones con LLM - * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para personalización de LLM + * Compatibilidad con `llms.txt` y `llms-full.txt` personalizados: agrégalos a la raíz del repositorio de documentación para servirlos en los endpoints `/llms.txt` y `/llms-full.txt` para la personalización de LLM * Se añadió la [integración de Analytics de Hightouch](/es/integrations/analytics/hightouch#hightouch) - * Seguimiento de analytics del menú contextual mejorado (la visualización en el dashboard llegará pronto) - * Se añadieron pruebas de extremo a extremo para `llms.txt` y `llms-full.txt` para garantizar una entrega correcta + * Seguimiento de Analytics mejorado en el menú contextual (visualización en el dashboard próximamente) + * Se añadieron pruebas de extremo a extremo (e2e) para `llms.txt` y `llms-full.txt` para garantizar su correcta entrega - ## Mejoras de componentes y estilo + ## Mejoras de componentes y estilos * Compatibilidad con classnames personalizados en etiquetas `h{1-4}` para aplicar estilos de encabezado personalizados - * Se corrigió que las etiquetas `h{1-4}` se renderizaran como componentes `Heading` con chips en el modo de página personalizada - * Se añadieron selectores CSS a [breadcrumbs](/es/navigation#breadcrumbs) para aplicar CSS personalizado - * Se corrigieron imágenes de open graph estiradas analizando dimensiones para mantener las proporciones a 56px de height + * Se corrigió que las etiquetas `h{1-4}` se renderizaran como componentes `Heading` con chips en modo de página personalizada + * Se añadieron selectores CSS a [breadcrumbs](/es/organize/navigation#breadcrumbs) para objetivos CSS personalizados + * Se corrigieron imágenes de Open Graph estiradas analizando dimensiones para mantener las proporciones a 56px de height * Se corrigió `VSCode` a `VS Code` en el menú contextual cuando está habilitado - * Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenido junto con los encabezados semánticos + * Se corrigió que los encabezados dentro de componentes personalizados aparecieran en la tabla de contenidos junto con encabezados semánticos ## Correcciones de errores y confiabilidad * Se corrigieron problemas de renderizado de PDF con ciertos títulos de página al sanear caracteres que causaban problemas de generación - * Se resolvió el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos JSON de OpenAPI vacíos - * Se corrigió que las metatags de open graph personalizadas de `docs.json` fueran sobrescritas por las generadas - * Se corrigieron los clics del botón del feed RSS al aterrizar en enlaces de anclaje usando origin + pathname para los enlaces de RSS + * Se resolvió el error de la CLI `Cannot convert undefined or null to object` al encontrar archivos OpenAPI JSON vacíos + * Se corrigió que las metatags de Open Graph personalizadas en `docs.json` fueran sobrescritas por las generadas + * Se corrigieron los clics del botón del feed RSS al aterrizar en enlaces de anclaje usando origin + pathname para los enlaces RSS * Se mejoró la velocidad de descarga de la CLI eliminando sourcemaps ## Mejoras técnicas - * Se añadieron pruebas visuales al pipeline de CI para una detección más temprana de regresiones + * Se añadieron pruebas visuales al pipeline de CI para detectar regresiones antes * Se mejoró el manejo de errores y las capacidades de depuración * Cobertura de pruebas integral para nuevas funciones y casos límite @@ -253,88 +253,88 @@ noindex: true ## Mejoras de autenticación - * Mejoras en el desarrollo local de autenticación, lo que permite un desarrollo más rápido de funciones y correcciones de errores en esta área del producto - * Implementaciones de vista previa ahora disponibles para sitios protegidos por autenticación + * Mejoras en el desarrollo local de auth, lo que permite iterar más rápido en funciones de auth y corregir errores en esta área del producto + * Implementaciones de vista previa disponibles para sitios protegidos por auth * Se corrigió el comportamiento de redirección para devolver correctamente a los usuarios a su página original después de autenticarse * Se corrigió la visualización del botón de cerrar sesión para la autenticación completa (antes solo funcionaba con autenticación parcial) ## Mejoras del área de pruebas de la API - * Se corrigió la carga de archivos `multipart/form-data` en el área de pruebas de la API - * Se corrigió el comportamiento de los enlaces de anclaje para que al hacer clic actualicen la URL sin desplazarse al inicio de la página + * Se corrigió la carga de archivos con `multipart/form-data` en el área de pruebas de la API + * Se corrigió el comportamiento de los enlaces de anclaje para que, al hacer clic, actualicen la URL sin desplazarse al inicio de la página * Se corrigieron problemas de enlaces de anclaje en pestañas anidadas ## Actualizaciones del assistant - * Nueva Assistant API para que puedas integrarlo en tus propios productos, compatible con el SDK de IA - * Se agregó un botón para copiar en las respuestas del chat + * Nueva Assistant API para integrarlo en tus propios productos, compatible con el AI SDK + * Se añadió un botón de copiar a las respuestas del chat * Se corrigió un problema al reintentar mensajes en el assistant - * Mejoras al prompt predeterminado del assistant para que sea menos verboso de forma predeterminada + * Mejoras al prompt predeterminado del assistant para que sea menos verboso por defecto ## Rendimiento y confiabilidad - * La búsqueda ahora se siente más ágil y precisa al abortar solicitudes con debounce a medida que escribes - * Aprovisionamiento de recursos para una nueva CDN: se espera que los tiempos de carga de imágenes y de páginas mejoren pronto - * Se corrigieron errores al renderizar diagramas Mermaid complejos como gráficos de Gantt - * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se agregaron pruebas para evitar regresiones + * Búsqueda más ágil y precisa al abortar solicitudes con debounce mientras escribes + * Aprovisionamiento de recursos para una nueva CDN: se espera que los tiempos de carga de imágenes y páginas mejoren pronto + * Se corrigieron errores al renderizar diagramas complejos de Mermaid como gráficos de GANTT + * Se corrigieron errores de la CLI en Windows para mejorar la estabilidad y se añadieron pruebas para prevenir regresiones ## Mejoras técnicas - * Se agregó OpenTelemetry para trazas en la aplicación NextJS para mejorar el tiempo hasta el primer byte para los clientes - * Se migró de Octokit a GitHub API Client para mejorar la latencia en la experiencia del editor web + * Se añadió OpenTelemetry para trazas en la aplicación NextJS y mejorar el tiempo hasta el primer byte para los clientes + * Migración de Octokit a GitHub API Client para mejorar la latencia en la experiencia del editor web * Se corrigieron etiquetas meta duplicadas para OpenGraph * Se actualizó MongoDB de la versión 6 a la 7 para mejorar el rendimiento y añadir nuevas funciones - ## Slack app + ## Aplicación de Slack * Acceso sin fricción: el bot responde a DMs, @menciones y cualquier pregunta en tu canal `#ask-ai` * Configuración con un clic: instálala directamente desde tu Dashboard de Mintlify en segundos * Respuestas contextuales: busca en toda tu documentación para ofrecer respuestas relevantes y precisas - * Reduce interrupciones de soporte: convierte preguntas diarias en respuestas instantáneas de autoservicio + * Reduce interrupciones de soporte: convierte las preguntas diarias en respuestas instantáneas de autoservicio - Obtén más información en nuestra [guía de Slack app](/es/ai/slack-app). + Obtén más información en nuestra [guía de la aplicación de Slack](/es/ai/slack-app). ## Servidores MCP alojados - Implementa servidores de Model Context Protocol (MCP) alojados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). + Implementa servidores Model Context Protocol (MCP) alojados directamente a través de Mintlify para integrarte con herramientas de IA como Claude, Cursor y otras. Obtén más información en nuestra [guía de MCP](/es/ai/model-context-protocol). Ayuda a los usuarios a conectar rápidamente tu servidor MCP con Cursor o VS Code desde cualquier página de tu documentación mediante el menú contextual. Consulta [Menú contextual](/es/ai/contextual-menu) para más información. ## Mejoras en el bloque de código - * Resaltado de sintaxis mejorado - * Se agregaron más opciones de personalización, incluyendo modo de enfoque, bloques de código expandibles, respuesta a modos oscuro y light, menú desplegable de lenguaje, numeración de líneas e iconos + * Mejor resaltado de sintaxis + * Se añadieron más opciones de personalización, incluido el modo de enfoque, bloques de código expandibles, adaptación a modo oscuro y claro, menú desplegable de lenguaje, numeración de líneas e iconos ## Actualizaciones del Asistente de IA - * Mayor precisión mediante RAG agentivo con llamadas a herramientas + * Mayor precisión mediante RAG agente con llamadas a herramientas * Proporciona enlaces navegables a las páginas de referencia para que los usuarios puedan ir directamente a la fuente de las respuestas * Atajo para copiar ejemplos de código generados por el assistant * Atajo "Ask AI" en bloques de código de la documentación para generar explicaciones desde el assistant - Obtén más información en la [documentación del assistant](/es/guides/assistant). + Obtén más información en la [documentación del assistant](/es/ai/assistant). - ## Cambios suscribibles + ## Registros de cambios suscribibles * Genera automáticamente un feed RSS a partir de las páginas de cambios - * Integra actualizaciones habilitadas por RSS con Slack, correo electrónico y otras herramientas + * Integra actualizaciones con RSS con Slack, correo electrónico y otras herramientas - Obtén más información en nuestra nueva [guía de cambios](/es/guides/changelogs) + Obtén más información en nuestra nueva [guía de cambios](/es/create/changelogs) ## Actualizaciones de estabilidad del área de pruebas de la API - * Búsqueda para encontrar un endpoint + * Busca para encontrar un endpoint * Indica un endpoint en desuso con una etiqueta - * Oculta las páginas de API autogeneradas de la navigation + * Oculta páginas de API autogeneradas de navigation * Carga archivos multipart o de datos de formulario - Obtén más información en la [documentación del área de pruebas de la API.](/es/api-playground/) + Obtén más información en la [documentación del área de pruebas de la API](/es/api-playground/) ## `mint update` @@ -508,11 +508,11 @@ noindex: true ![Asistente de IA](/images/changelog/ai-assistant.jpg) - Ahora puedes pedirle a la IA que haga cambios en tu documentación con el contexto de todo el contenido existente. Escribe una instrucción y el redactor propondrá cambios generando una solicitud de extracción. + Ahora puedes pedirle a la IA que realice cambios en tu documentación con el contexto de todo lo existente. Escribe una instrucción y el redactor propondrá cambios generando una solicitud de extracción. ## Mejora de la integración con GitLab - Hemos mejorado la sincronización con GitLab, habilitando actualizaciones automatizadas y implementaciones de vista previa. Consulta nuestra [documentación sobre GitLab](/es/settings/gitlab) para comenzar. + Hemos mejorado la sincronización con GitLab, habilitando, por ejemplo, actualizaciones automatizadas e implementaciones de vista previa. Consulta nuestra [documentación sobre GitLab](/es/deploy/gitlab) para comenzar. ## Editor web @@ -520,7 +520,7 @@ noindex: true ![Editor web](/images/changelog/webeditor.jpg) - Hemos renovado nuestro editor web para que puedas actualizar la documentación con una experiencia totalmente WYSIWYG, mientras se sincroniza con Markdown. + Hemos renovado nuestro editor web para que ahora puedas actualizar la documentación con una experiencia WYSIWYG completa, sincronizada con Markdown. Consulta nuestra [documentación para comenzar con el Editor web](/es/editor). @@ -534,12 +534,12 @@ noindex: true ## Localización - Ahora puedes localizar tu documentación, de forma similar al versionado. Agrega un `locale` a una versión y el contenido fijo en Mintlify, como “¿Te resultó útil esta página?”, también coincidirá con el locale. + Ahora puedes localizar tu documentación, de manera similar al versionado. Agrega un `locale` a una versión y el contenido fijo en Mintlify, como “¿Te resultó útil esta página?”, también coincidirá con el locale. ### Mejoras de calidad - * Devolver resultados de chat y búsqueda según la versión que el usuario esté leyendo - * Autenticar a los usuarios con OAuth, además de JWT (JSON Web Token) o tokens de sesión compartida. + * Devolver resultados de chat y búsqueda basados en la versión actual que el usuario está leyendo + * Autenticar a los usuarios con OAuth, además de JWT o tokens de sesión compartida. diff --git a/es/components/accordions.mdx b/es/components/accordions.mdx index d9d90c3fb..6e2723a1f 100644 --- a/es/components/accordions.mdx +++ b/es/components/accordions.mdx @@ -1,12 +1,11 @@ --- title: "Accordions" -description: "Componentes desplegables para mostrar u ocultar contenido" -icon: "chevron-down" +description: "Componentes desplegables para mostrar y ocultar contenido" --- import IconsOptional from "/snippets/es/icons-optional.mdx"; -Los Accordions permiten a los usuarios expandir y contraer secciones de contenido. Usa los Accordions para la revelación progresiva y para organizar la información. +Los Accordion permiten que los usuarios expandan y contraigan secciones de contenido. Usa Accordion para la revelación progresiva y para organizar la información.
@@ -44,11 +43,11 @@ Los Accordions permiten a los usuarios expandir y contraer secciones de contenid ## Grupos de Accordion
-Agrupa Accordions relacionados con ``. Esto crea una sección coherente de Accordions que se pueden expandir o contraer individualmente. +Agrupa acordeones relacionados usando ``. Esto crea una sección coherente de acordeones que se pueden expandir o contraer individualmente. - Puedes incluir otros componentes dentro de los Accordions. + Puedes incluir otros componentes dentro de los Accordion. ```java HelloWorld.java class HelloWorld { @@ -60,7 +59,7 @@ Agrupa Accordions relacionados con ``. Esto crea una sección co - Añade iconos para que los Accordions sean más distintivos visualmente y fáciles de explorar de un vistazo. + Añade iconos para que los acordeones sean más distintivos visualmente y fáciles de recorrer de un vistazo. @@ -106,7 +105,7 @@ Agrupa Accordions relacionados con ``. Esto crea una sección co - Indica si el Accordion está abierto de manera predeterminada. + Indica si el Accordion se abre de forma predeterminada. - + \ No newline at end of file diff --git a/es/components/banner.mdx b/es/components/banner.mdx index 47ebfd40d..f737b9223 100644 --- a/es/components/banner.mdx +++ b/es/components/banner.mdx @@ -1,7 +1,6 @@ --- title: "Banner" description: "Agrega un banner para mostrar anuncios y notificaciones importantes en todo el sitio" -icon: "layout-panel-top" --- Usa banners para mostrar anuncios, actualizaciones o notificaciones importantes en todo tu sitio de documentación. Los banners aparecen en la parte superior de cada página, admiten formato Markdown y se pueden hacer descartables. @@ -11,14 +10,14 @@ Para agregar un banner, usa la propiedad `banner` en tu `docs.json`: ```json Product announcements wrap "banner": { - "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/changelog) para más detalles.", + "content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [cambios](/changelog) para más detalles.", "dismissible": true } ``` ```json Maintenance notices wrap "banner": { - "content": "⚠️ Mantenimiento programado: la API no estará disponible el 15 de diciembre, 2:00–4:00 a. m. UTC", + "content": "⚠️ Mantenimiento programado: la API no estará disponible el 15 de diciembre, de 2 a 4 a. m. UTC", "dismissible": false } ``` diff --git a/es/components/callouts.mdx b/es/components/callouts.mdx index 8901b75d5..fcdc58919 100644 --- a/es/components/callouts.mdx +++ b/es/components/callouts.mdx @@ -1,18 +1,17 @@ --- -title: 'Llamadas de atención' -description: 'Usa llamadas de atención para agregar contexto llamativo a tu contenido' -icon: 'info' +title: 'Avisos' +description: 'Usa avisos para añadir contexto llamativo a tu contenido' --- -Las llamadas de atención pueden tener el estilo de Note, Advertencia, Información, Sugerencia, Check, Danger, o puedes crear tu propia llamada de atención: +Los avisos se pueden configurar como Note, Advertencia, Información, Sugerencia, Check, Danger, o puedes crear tu propio aviso: -Esto agrega una nota en el contenido +Esto añade una nota en el contenido ```mdx Esto agrega una nota en el contenido ``` -Esto muestra una advertencia a la que debes prestar atención +Esto genera una Advertencia a la que debes prestar atención ```mdx Esto genera una advertencia a tener en cuenta @@ -24,25 +23,25 @@ Las llamadas de atención pueden tener el estilo de Note, Advertencia, Informaci Esto resalta información importante ``` -Esto muestra una Sugerencia útil +Esto ofrece una Sugerencia útil ```mdx Esto sugiere una sugerencia útil ``` -Esto nos devuelve un estado verificado +Esto nos da un estado verificado ```mdx Esto nos da un estado marcado ``` -Esta es una nota de advertencia +Este es un aviso de riesgo ```mdx Esta es una alerta de peligro ``` - Este es un llamado de atención personalizado + Este es un aviso personalizado ```mdx wrap Esta es una llamada de atención personalizada diff --git a/es/components/cards.mdx b/es/components/cards.mdx index 627cd112c..d3b5c437e 100644 --- a/es/components/cards.mdx +++ b/es/components/cards.mdx @@ -1,7 +1,6 @@ --- title: "Tarjetas" -description: "Destaca puntos clave o enlaces con diseños e iconos personalizables" -icon: "square-mouse-pointer" +description: "Destaca los puntos clave o los enlaces con diseños e iconos personalizables" --- import IconsOptional from "/snippets/es/icons-optional.mdx"; diff --git a/es/components/code-groups.mdx b/es/components/code-groups.mdx index c02e9a89e..cf160a6e1 100644 --- a/es/components/code-groups.mdx +++ b/es/components/code-groups.mdx @@ -1,7 +1,6 @@ --- title: "Grupos de código" description: "Muestra varios ejemplos de código en un solo componente" -icon: "group" --- Usa el componente `CodeGroup` para mostrar varios bloques de código en una interfaz con Tabs, lo que permite a los usuarios comparar implementaciones en distintos lenguajes de programación o ver enfoques alternativos para la misma tarea. @@ -24,7 +23,7 @@ Usa el componente `CodeGroup` para mostrar varios bloques de código en una inte ``` -Los grupos de código heredan los estilos globales de tu archivo `docs.json`. Personaliza tu tema usando `styling.codeblocks`. Consulta [Settings](/es/settings#styling) para ver las opciones de configuración. +Los grupos de código heredan el estilo global de tu archivo `docs.json`. Personaliza tu tema usando `styling.codeblocks`. Consulta [Settings](/es/organize/settings#styling) para ver opciones de configuración.
## Creación de grupos de código diff --git a/es/components/columns.mdx b/es/components/columns.mdx index d420e3cb3..76f6f7ee6 100644 --- a/es/components/columns.mdx +++ b/es/components/columns.mdx @@ -1,19 +1,18 @@ --- title: 'Columnas' -description: 'Muestra tarjetas una al lado de la otra en un formato de cuadrícula' -icon: 'columns-2' +description: 'Muestra tarjetas en paralelo en una cuadrícula' keywords: ['grupos de tarjetas'] --- -El componente `Columns` te permite agrupar varios componentes `Card`. Se usa principalmente para colocar tarjetas en una cuadrícula, especificando el número de columnas. +El componente `Columns` te permite agrupar varios componentes `Card`. Se usa con mayor frecuencia para colocar tarjetas en una cuadrícula, especificando el número de columnas. - + Configura tu proyecto con nuestra guía de inicio rápido. - - Explora endpoints, parámetros y ejemplos de tu API. + + Explora endpoints, parámetros y ejemplos para tu API. diff --git a/es/components/examples.mdx b/es/components/examples.mdx index f0c936287..cbe598a4f 100644 --- a/es/components/examples.mdx +++ b/es/components/examples.mdx @@ -1,10 +1,9 @@ --- title: "Ejemplos" description: "Muestra bloques de código en la barra lateral derecha en equipos de escritorio" -icon: 'between-horizontal-start' --- -Los componentes `` y `` muestran bloques de código en la barra lateral derecha para crear un diseño de dos columnas que mantiene los ejemplos visibles mientras los usuarios se desplazan por tu contenido. Estos componentes están pensados para la documentación de API, pero funcionan en todas las páginas. +Los componentes `` y `` muestran bloques de código en la barra lateral derecha para crear un diseño de dos columnas que mantiene los ejemplos visibles mientras los usuarios se desplazan por tu contenido. Estos componentes están diseñados para la documentación de API, pero funcionan en todas las páginas. Casos de uso comunes: @@ -13,7 +12,7 @@ Casos de uso comunes: * Fragmentos de código que los usuarios consultan mientras siguen instrucciones * Ejemplos de “antes y después” en tutoriales -En dispositivos móviles, los componentes `` y `` se muestran como bloques de código “regular” y se pueden omitir al desplazarse. +En dispositivos móviles, los componentes `` y `` se muestran como bloques de código normales y se pueden omitir al desplazarse. ```bash Request diff --git a/es/components/expandables.mdx b/es/components/expandables.mdx index 06255a564..0ce5f699a 100644 --- a/es/components/expandables.mdx +++ b/es/components/expandables.mdx @@ -1,10 +1,9 @@ --- -title: "Expandables" +title: "Expandibles" description: "Alternar para mostrar propiedades anidadas" -icon: "list-tree" --- -Usa expandables para mostrar u ocultar contenido anidado dentro de los campos de respuesta. Los expandables son especialmente útiles para mostrar propiedades de objetos complejos en la documentación de la API. +Usa expandibles para mostrar y ocultar contenido anidado dentro de los campos de respuesta. Los expandibles son especialmente útiles para presentar propiedades de objetos complejos en la documentación de API. @@ -13,7 +12,7 @@ Usa expandables para mostrar u ocultar contenido anidado dentro de los campos de - Si el usuario tiene más de 21 años + Indica si el usuario tiene más de 21 años @@ -38,9 +37,9 @@ Usa expandables para mostrar u ocultar contenido anidado dentro de los campos de
- El nombre del objeto que se está mostrando. + El nombre del objeto que se muestra. Configúralo en `true` para que el elemento expandible se abra al cargar la página. - + \ No newline at end of file diff --git a/es/components/fields.mdx b/es/components/fields.mdx index b4a7f3852..2445d5fb6 100644 --- a/es/components/fields.mdx +++ b/es/components/fields.mdx @@ -1,10 +1,9 @@ --- title: "Campos" -description: "Configura parámetros para tus referencias de API o SDK" -icon: "letter-text" +description: "Configura los parámetros de tus referencias de API o SDK" --- -Usa campos para documentar los parámetros y las respuestas de tu API. Hay dos tipos de campos: campos de parámetros y campos de respuestas. +Usa campos para documentar los parámetros y las respuestas de la API. Hay dos tipos de campos: campos de parámetros y campos de respuesta.
## Campo de parámetro @@ -13,7 +12,7 @@ Usa campos para documentar los parámetros y las respuestas de tu API. Hay dos t El componente `` se utiliza para definir parámetros de tus API o SDK. Al agregar un `ParamField`, se añade automáticamente un [área de pruebas de la API](/es/api-playground/overview). - Un ejemplo de un campo de parámetro + Un ejemplo de campo de parámetro ```mdx @@ -27,7 +26,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD
- Indica si el parámetro es de tipo query, ruta, cuerpo o encabezado. Seguido del + Indica si el parámetro es de query, ruta, cuerpo o encabezado. Seguido del nombre del parámetro. @@ -36,7 +35,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD Admite `number`, `string`, `boolean`, `object`. - Los arrays se pueden definir con el sufijo `[]`. Por ejemplo, `string[]`. + Los arreglos se pueden definir con el sufijo `[]`. Por ejemplo, `string[]`. @@ -52,7 +51,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD - Texto del marcador de posición para el campo en el playground. + Texto del marcador de posición para la entrada en el entorno de pruebas. @@ -66,7 +65,7 @@ El componente `` se utiliza para definir parámetros de tus API o SD El componente `` define los valores de retorno de una API. - Ejemplo de un campo de respuesta + Un ejemplo de un campo de respuesta ```mdx @@ -105,4 +104,4 @@ El componente `` define los valores de retorno de una API. Etiquetas que se muestran después del nombre del campo. - + \ No newline at end of file diff --git a/es/components/frames.mdx b/es/components/frames.mdx index a75403ab8..62d5bc8fa 100644 --- a/es/components/frames.mdx +++ b/es/components/frames.mdx @@ -1,13 +1,12 @@ --- title: "Frames" description: "Envuelve imágenes u otros componentes en un contenedor" -icon: "frame" --- -Usa frames para mostrar imágenes, diagramas u otro contenido visual con un estilo uniforme y subtítulos opcionales. Los frames centran el contenido y proporcionan separación visual del texto circundante. +Usa los Frames para mostrar imágenes, diagramas u otro contenido visual con un estilo uniforme y leyendas opcionales. Los Frames centran el contenido y lo separan visualmente del texto que lo rodea. - Fotografía de un lago rodeado de árboles, con montañas a lo lejos en el Parque Nacional de Yellowstone. + Fotografía de un lago rodeado de árboles, con montañas a lo lejos, en el Parque Nacional de Yellowstone.
diff --git a/es/components/icons.mdx b/es/components/icons.mdx index 0e2dabc93..e1d69c464 100644 --- a/es/components/icons.mdx +++ b/es/components/icons.mdx @@ -1,12 +1,11 @@ --- title: "Iconos" -description: "Utiliza iconos de bibliotecas de iconos populares" -icon: "flag" +description: "Usa iconos de bibliotecas populares de iconos" --- import IconsRequired from "/snippets/es/icons-required.mdx"; -Usa iconos de Font Awesome, Lucide, SVG (Scalable Vector Graphics), URL externas o archivos de tu proyecto para mejorar tu documentación. +Usa iconos de Font Awesome, Lucide, SVG (Scalable Vector Graphics), URLs externas o archivos de tu proyecto para mejorar tu documentación. @@ -21,7 +20,7 @@ Usa iconos de Font Awesome, Lucide, SVG (Scalable Vector Graphics), URL externas Los iconos se colocan en línea cuando se utilizan dentro de un párrafo. - La documentación que quieres, sin complicaciones. + La documentación que quieres, sin esfuerzo. ```markdown Inline icon example La documentación que necesitas, sin complicaciones. @@ -40,4 +39,4 @@ Los iconos se colocan en línea cuando se utilizan dentro de un párrafo. El tamaño del icon en píxeles. - + \ No newline at end of file diff --git a/es/components/mermaid-diagrams.mdx b/es/components/mermaid-diagrams.mdx index 95da2ec75..d3a65a597 100644 --- a/es/components/mermaid-diagrams.mdx +++ b/es/components/mermaid-diagrams.mdx @@ -1,12 +1,11 @@ --- title: "Mermaid" description: "Muestra diagramas con Mermaid" -icon: "waypoints" --- -[Mermaid](https://mermaid.js.org/) te permite crear diagramas de flujo, de secuencia, de Gantt y otros, a partir de texto y código. +[Mermaid](https://mermaid.js.org/) te permite crear diagramas de flujo, de secuencia, de Gantt y otros diagramas usando texto y código. -Para ver la lista completa de tipos de diagramas compatibles y su sintaxis, consulta la [documentación de Mermaid](https://mermaid.js.org/intro/). +Para ver la lista completa de tipos de diagramas y su sintaxis, consulta la [documentación de Mermaid](https://mermaid.js.org/intro/). ```mermaid flowchart LR @@ -18,12 +17,12 @@ Para ver la lista completa de tipos de diagramas compatibles y su sintaxis, cons direction TB top2[arriba] --> bottom2[abajo] end - %% ^ Estos subgrafos son idénticos, excepto por los enlaces hacia ellos: + %% ^ Estos subgráficos son idénticos, excepto por los enlaces que los conectan: %% Enlace *hacia* subgraph1: se mantiene la dirección de subgraph1 outside --> subgraph1 %% Enlace *dentro de* subgraph2: - %% subgraph2 hereda la dirección del grafo de nivel superior (LR) + %% subgraph2 hereda la dirección del gráfico de nivel superior (LR) outside ---> top2 ``` diff --git a/es/components/panel.mdx b/es/components/panel.mdx index 036c713c9..1614e685d 100644 --- a/es/components/panel.mdx +++ b/es/components/panel.mdx @@ -1,14 +1,13 @@ --- title: 'Panel' description: 'Especifica el contenido del panel lateral derecho' -icon: 'panel-right' --- Puedes usar el componente `` para personalizar el panel lateral derecho de una página con cualquier componente que quieras. -Si una página incluye un ``, los componentes [RequestExample](/es/components/examples#request-example) y [ResponseExample](/es/components/examples#response-example) deben ubicarse dentro de ``. +Si una página tiene un componente ``, los componentes [RequestExample](/es/components/examples#request-example) y [ResponseExample](/es/components/examples#response-example) deben estar dentro de ``. -Los componentes en un `` sustituirán la tabla de contenidos de la página. +Los componentes dentro de `` reemplazarán la tabla de contenidos de la página. ```mdx @@ -17,5 +16,5 @@ Los componentes en un `` sustituirán la tabla de contenidos de la págin ``` - Fija Información en el panel lateral. O agrega cualquier otro componente. + Fija Información en el panel lateral. O añade cualquier otro componente. diff --git a/es/components/steps.mdx b/es/components/steps.mdx index d47db06db..05d7728b2 100644 --- a/es/components/steps.mdx +++ b/es/components/steps.mdx @@ -1,37 +1,36 @@ --- title: "Pasos" -description: "Organiza contenido en secuencia con el componente Steps" -icon: "list-todo" +description: "Secuencia contenido con el componente Steps" --- import IconsOptional from "/snippets/es/icons-optional.mdx"; -Usa pasos para mostrar una serie de acciones o eventos en secuencia. Puedes añadir tantos pasos como necesites. +Utiliza pasos para mostrar una serie de acciones o eventos secuenciales. Puedes agregar tantos pasos como necesites. - - Estas son instrucciones o contenido que solo aplican al primer paso. + + Estas son instrucciones o contenido que solo corresponden al primer paso. - - Estas son instrucciones o contenido que solo aplican al segundo paso. + + Estas son instrucciones o contenido que solo corresponden al segundo paso. - - Estas son instrucciones o contenido que solo aplican al tercer paso. + + Estas son instrucciones o contenido que solo corresponden al tercer paso. ```mdx Steps example - Estas son instrucciones o contenido que solo se refieren al primer paso. + Estas son instrucciones o contenido que solo corresponden al primer paso. - Estas son instrucciones o contenido que solo se refieren al segundo paso. + Estas son instrucciones o contenido que solo corresponden al segundo paso. - Estas son instrucciones o contenido que solo se refieren al tercer paso. + Estas son instrucciones o contenido que solo corresponden al tercer paso. ``` @@ -49,20 +48,18 @@ Usa pasos para mostrar una serie de acciones o eventos en secuencia. Puedes aña El tamaño de los títulos de los pasos. Uno de `p`, `h2` y `h3`. - -
- ## Propiedades individuales de cada paso + ## Propiedades individuales del paso
- El contenido de un paso, ya sea como texto plano o como componentes. + El contenido de un paso, ya sea texto sin formato o componentes. - El título es el texto principal del paso y aparece junto al indicador. + El Título es el texto principal del paso y aparece junto al indicador. @@ -70,5 +67,5 @@ Usa pasos para mostrar una serie de acciones o eventos en secuencia. Puedes aña - El tamaño de los títulos del paso. Uno de `p`, `h2` y `h3`. - + El tamaño de los títulos del paso. Uno de: `p`, `h2` o `h3`. + \ No newline at end of file diff --git a/es/components/tabs.mdx b/es/components/tabs.mdx index b2b4fb982..45a344bf3 100644 --- a/es/components/tabs.mdx +++ b/es/components/tabs.mdx @@ -1,14 +1,13 @@ --- title: "Tabs" -description: "Alterna el contenido con el componente Tabs" -icon: "panel-top" +description: "Alterna contenido usando el componente Tabs" --- -Usa pestañas para organizar el contenido en varios paneles entre los que las personas pueden alternar. Puedes añadir cualquier número de pestañas e incluir otros componentes dentro de cada una. +Usa pestañas para organizar el contenido en varios paneles entre los que los usuarios pueden cambiar. Puedes añadir cualquier número de pestañas e incluir otros componentes dentro de cada pestaña. - - ☝️ Te damos la bienvenida al contenido que solo puedes ver dentro de la primera pestaña. + + ☝️ Bienvenido al contenido que solo puedes ver dentro de la primera pestaña. Puedes añadir cualquier número de componentes dentro de las pestañas. Por ejemplo, un bloque de código: @@ -21,13 +20,13 @@ Usa pestañas para organizar el contenido en varios paneles entre los que las pe ``` - + ✌️ Aquí tienes contenido que solo está dentro de la segunda pestaña. - ¡Esta tiene un icono ! + ¡Esta tiene un icon! - + 💪 Aquí tienes contenido que solo está dentro de la tercera pestaña. @@ -63,7 +62,7 @@ Usa pestañas para organizar el contenido en varios paneles entre los que las pe
- El título de la Tab. Los títulos cortos facilitan la navegación. + El title de la Tab. Los títulos cortos facilitan la navegación. @@ -71,5 +70,5 @@ Usa pestañas para organizar el contenido en varios paneles entre los que las pe - Solo para iconos de Font Awesome: uno de `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. - + Solo para icon de Font Awesome: Uno de `regular`, `solid`, `light`, `thin`, `sharp-solid`, `duotone`, `brands`. +
\ No newline at end of file diff --git a/es/components/tooltips.mdx b/es/components/tooltips.mdx index 77b5c4fc0..4599101a4 100644 --- a/es/components/tooltips.mdx +++ b/es/components/tooltips.mdx @@ -1,12 +1,11 @@ --- title: "Tooltips" description: "Muestra una definición al pasar el cursor sobre el texto" -icon: "message-square" --- -Usa tooltips para ofrecer contexto adicional o definiciones cuando una persona pasa el cursor sobre un texto. Los tooltips pueden incluir enlaces de llamada a la acción opcionales. +Usa los tooltips para ofrecer contexto adicional o definiciones cuando un usuario pasa el cursor sobre una cadena de texto. Los tooltips pueden incluir enlaces opcionales de llamada a la acción. -**Ejemplo**: API La documentación ayuda a los desarrolladores a entender cómo integrarse con tu servicio. +**Ejemplo**: API La documentación ayuda a los desarrolladores a entender cómo integrarse con tu servicio. ```mdx Tooltip example wrap API La documentación de API ayuda a los desarrolladores a entender cómo integrar con tu servicio. diff --git a/es/components/update.mdx b/es/components/update.mdx index 9ef94733b..af5019e3b 100644 --- a/es/components/update.mdx +++ b/es/components/update.mdx @@ -1,15 +1,14 @@ --- title: "Update" -description: "Lleva un registro de cambios y actualizaciones" -icon: "list-collapse" +description: "Haz un seguimiento de los cambios y las actualizaciones" --- -Usa el componente `Update` para mostrar entradas del changelog, actualizaciones de versión y notas de lanzamiento con un formato coherente. +Usa el componente `Update` para mostrar entradas del registro de cambios, actualizaciones de versión y notas de lanzamiento con un formato coherente. - ## Actualización de ejemplo + ## Ejemplo de actualización - Puedes añadir cualquier cosa aquí, como una captura de pantalla, un fragmento de código o una lista de cambios. + Aquí puedes agregar cualquier cosa, como una captura de pantalla, un fragmento de código o una lista de cambios. @@ -19,7 +18,7 @@ Usa el componente `Update` para mostrar entradas del changelog, actualizaciones * Diseño adaptable * Ancla para cada actualización - * Entrada del feed RSS generada para cada actualización + * Entrada de RSS generada para cada actualización
@@ -32,14 +31,14 @@ Usa el componente `Update` para mostrar entradas del changelog, actualizaciones ``` -Usa varios componentes `Update` para crear [cambios](/es/guides/changelogs). +Usa varios componentes `Update` para crear [cambios](/es/create/changelogs).
## Props
- label de la actualización. Aparece a la izquierda de la actualización y crea un enlace ancla. Los labels deben ser únicos. + label de la actualización. Aparece a la izquierda de la actualización y crea un enlace ancla. Las labels deben ser únicas. @@ -47,5 +46,5 @@ Usa varios componentes `Update` para crear [cambios](/es/guides/changelogs). - Descripción de la actualización. Aparece debajo del label y de la etiqueta. - + Descripción de la actualización. Aparece debajo del label y las etiquetas. + \ No newline at end of file diff --git a/es/contact-support.mdx b/es/contact-support.mdx index f0430bac0..05b8911eb 100644 --- a/es/contact-support.mdx +++ b/es/contact-support.mdx @@ -1,6 +1,5 @@ --- -title: "Contactar con el soporte" -icon: "circle-help" +title: "Contacta con soporte" description: "Estamos aquí para ayudarte a sacar el máximo partido a Mintlify" --- diff --git a/es/create/broken-links.mdx b/es/create/broken-links.mdx new file mode 100644 index 000000000..1b01b4923 --- /dev/null +++ b/es/create/broken-links.mdx @@ -0,0 +1,46 @@ +--- +title: "Redirecciones y enlaces rotos" +description: "Herramientas para prevenir enlaces no válidos" +--- + +Cuando cambias la ruta de un archivo en tu carpeta de docs, también cambia la ruta de la URL de esa página. Esto puede ocurrir al reestructurar tus docs o al cambiar el título de la barra lateral. + + + +Detecta enlaces rotos con nuestra CLI. [Instala la CLI](/es/installation) y ejecuta el comando: + +```bash +mint enlaces-rotos +``` + +La CLI identifica cualquier enlace relativo en tu documentación que no exista. + +
+ ## Redirecciones +
+ +Configura redirecciones 301 añadiendo el campo `redirects` a tu archivo `docs.json`. + +```json +"redirects": [ + { + "source": "/source/path", + "destination": "/destination/path" + } +] +``` + +Esto redirige de forma permanente `/source/path` a `/destination/path` para que no pierdas el SEO acumulado de la página original. + +Para hacer coincidir una ruta con comodín, usa `*` después de un parámetro. En este ejemplo, `/beta/:slug*` coincide con `/beta/introduction` y la redirige a `/v2/introduction`. + +```json +"redirects": [ + { + "source": "/beta/:slug*", + "destination": "/v2/:slug*" + } +] +``` diff --git a/es/create/changelogs.mdx b/es/create/changelogs.mdx new file mode 100644 index 000000000..50a47ac2d --- /dev/null +++ b/es/create/changelogs.mdx @@ -0,0 +1,145 @@ +--- +title: "Registro de cambios" +description: "Publica actualizaciones del producto en tu documentación con un feed RSS al que los usuarios pueden suscribirse" +--- + +Crea un registro de cambios para tu documentación agregando [componentes de actualización](/es/components/update) a una página. + +Consulta el [registro de cambios de Mintlify](/es/changelog) como ejemplo: en cada actualización puedes incluir enlaces, imágenes, texto y demostraciones de tus nuevas funciones. + +
+ ## Configurar tu página de cambios +
+ + + + 1. Crea una nueva página en tu documentación, por ejemplo `changelog.mdx` o `updates.mdx`. + 2. Añade tu página de cambios al esquema de navigation en tu `docs.json`. + + + + Añade un `Update` para cada entrada del registro. + + Incluye información relevante como lanzamientos de funcionalidades, correcciones de errores u otros anuncios. + + + +```mdx Example changelog.mdx +--- +title: "Cambios" +description: "Actualizaciones del producto y anuncios" +--- + + Se agregó un nuevo sabor Wintergreen. + + Se lanzó una nueva versión del sabor Spearmint, ahora con 10% más menta. + + + + Se lanzó una nueva versión del sabor Spearmint. + +``` + +
+ ## Personalizar tu página de cambios +
+ +Controla cómo las personas navegan por tu página de cambios y se mantienen al día con la información de tu producto. + +
+ ### Tabla de contenidos +
+ +Cada propiedad `label` de un `Update` crea automáticamente una entrada en la tabla de contenidos de la barra lateral derecha. Esta es la navigation predeterminada para tu página de cambios. + + + Página de cambios con la tabla de contenidos mostrada en modo claro. + + Página de cambios con la tabla de contenidos mostrada en modo oscuro. + + +
+ ### Filtros por etiquetas +
+ +Agrega `tags` a tus componentes `Update` para reemplazar la tabla de contenido con filtros por etiquetas. Los usuarios pueden filtrar los cambios seleccionando una o varias etiquetas: + +```mdx Tag filters example wrap + + Se agregó un nuevo sabor Wintergreen. + + Se lanzó una nueva versión del sabor Spearmint, ahora con 10% más menta. + + + + Se lanzó una nueva versión del sabor Spearmint. + + + + Se marcó como en desuso el sabor Peppermint. + + Se lanzó una nueva versión del sabor Spearmint. + +``` + + + Registro de cambios en modo claro con el filtro de etiqueta Peppermint seleccionado. + + Registro de cambios en modo oscuro con el filtro de etiqueta Peppermint seleccionado. + + + + La tabla de contenidos y los filtros del registro de cambios se ocultan al usar los modos de página `custom`, `center` o `wide`. Más información sobre los [modos de página](/es/organize/pages#page-mode). + + +
+ ### Registros de cambios a los que te puedes suscribir +
+ +Usar componentes `Update` crea un feed RSS al que te puedes suscribir en la URL de tu página con `/rss.xml` agregado. Por ejemplo, `mintlify.com/docs/changelog/rss.xml`. + +Las entradas se añaden al feed RSS cuando se publican nuevos componentes `Update` y cuando se agregan nuevos encabezados dentro de etiquetas `` existentes. + +Los encabezados de nivel superior de los componentes `Update` se utilizan como títulos de las entradas del feed RSS, y estas entradas enlazan a sus anclas de encabezado en tu documentación. + +```xml Example RSS feed + + + + <![CDATA[Actualizaciones del producto]]> + + https://mintlify.com/docs + RSS for Node + Mon, 21 Jul 2025 21:21:47 GMT + + + https://mintlify.com/docs + + <![CDATA[Junio 2025]]> + https://mintlify.com/docs/changelog#june-2025 + https://mintlify.com/docs/changelog#june-2025 + Mon, 23 Jun 2025 16:54:22 GMT + + + +``` + +Los feeds RSS pueden integrarse con Slack, correo electrónico u otras herramientas de suscripción para notificar a los usuarios sobre cambios en el producto. Algunas opciones incluyen: + +* [Slack](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack) +* [Correo electrónico](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email) mediante Zapier +* Bots de Discord como [Readybot](https://readybot.io) o [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot) + +Para que el feed RSS sea fácil de descubrir, puedes mostrar un botón con el icon RSS que enlace al feed en la parte superior de la página. Agrega `rss: true` al frontmatter de la página: + +```mdx +--- +rss: true +--- +``` + + + Página de cambios en modo claro con el botón RSS habilitado. + + Página de cambios en modo oscuro con el botón RSS habilitado. + diff --git a/es/create/code.mdx b/es/create/code.mdx new file mode 100644 index 000000000..1ebdc4b4d --- /dev/null +++ b/es/create/code.mdx @@ -0,0 +1,418 @@ +--- +title: "Dar formato al código" +description: "Mostrar código en línea y bloques de código" +--- + +
+ ## Agregar ejemplos de código +
+ +Puedes agregar fragmentos de código en línea o bloques de código. Los bloques de código admiten opciones de metadatos para el resaltado de sintaxis, títulos, resaltado de líneas, iconos y más. + +
+ ### Código en línea +
+ +Para indicar una `palabra` o `frase` como código, enciérrala entre acentos invertidos (`). + +```mdx +Para marcar una `palabra` o `frase` como código, enciérrala entre comillas invertidas (`). +``` + +
+ ### Bloques de código +
+ +Usa [bloques de código con cercas](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) encerrando el código entre tres comillas invertidas. Los bloques de código se pueden copiar y, si tienes el assistant habilitado, los usuarios pueden pedir a la IA que explique el código. + +Especifica el lenguaje de programación para el resaltado de sintaxis y para habilitar opciones meta. Agrega cualquier opción meta, como un title o icon, después del lenguaje. + + + ```java HelloWorld.java example lines icon="java" + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` + + ````mdx Format + ```java HelloWorld.java lines icon="java" + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` + ```` + + +
+ ## Opciones de bloque de código +
+ +Puedes agregar opciones meta a tus bloques de código para personalizar su apariencia. + + + Debes especificar un lenguaje de programación para un bloque de código antes de agregar cualquier otra opción meta. + + +
+ ### Sintaxis de opciones +
+ +* **Opciones de tipo cadena y booleanas**: Envuélvelas con `""`, `''` o sin comillas. +* **Opciones de expresión**: Envuélvelas con `{}`, `""` o `''`. + +
+ ### Resaltado de sintaxis +
+ +Activa el resaltado de sintaxis especificando el lenguaje de programación después de las comillas invertidas de apertura de un bloque de código. + +Usamos [Shiki](https://shiki.style/) para el resaltado de sintaxis y admitimos todos los lenguajes disponibles. Consulta la lista completa de [lenguajes](https://shiki.style/languages) en la documentación de Shiki. + +Personaliza los temas de los bloques de código de forma global usando `styling.codeblocks` en tu archivo `docs.json`. Establece temas simples como `system` o `dark`, o configura [temas de Shiki](https://shiki.style/themes) personalizados para los modos claro y oscuro. Consulta [Configuración](/es/organize/settings#styling) para ver las opciones de configuración. + + + ```java Ejemplo de resaltado de sintaxis + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` + + ````mdx Formato + ```java + class HelloWorld { + public static void main(String[] args) { + System.out.println("Hello, World!"); + } + } + ``` + ```` + + +
+ ### Twoslash +
+ +En bloques de código de JavaScript y TypeScript, utiliza `twoslash` para habilitar información de tipos interactiva. Los usuarios pueden pasar el cursor sobre variables, funciones y parámetros para ver los tipos y errores, como en un IDE. + + + ```ts twoslash Twoslash example + type Pet = "cat" | "dog" | "hamster"; + + function adoptPet(name: string, type: Pet) { + return `${name} the ${type} is now adopted!`; + } + + // Hover to see the inferred types + const message = adoptPet("Mintie", "cat"); + ``` + + ````mdx Format + ```ts twoslash + type Pet = "cat" | "dog" | "hamster"; + + function adoptPet(name: string, type: Pet) { + return `${name} the ${type} is now adopted!`; + } + + // Hover to see the inferred types + const message = adoptPet("Mintie", "cat"); + ``` + ```` + + +
+ ### Título +
+ +Añade un título para identificar tu ejemplo de código. Usa `title="Tu título"` o una cadena en una sola línea. + + + ```javascript Title example + const hello = "world"; + ``` + + ````mdx Format + ```javascript Title example + const hello = "world"; + ``` + ```` + + +
+ ### Icono +
+ +Agrega un icono a tu bloque de código usando la propiedad `icon`. Consulta [Iconos](/es/components/icons) para ver todas las opciones disponibles. + + + ```javascript Ejemplo de icono icon="square-js" + const hello = "world"; + ``` + + ````mdx Formato + ```javascript icon="square-js" + const hello = "world"; + ``` + ```` + + +
+ ### Resaltado de líneas +
+ +Resalta líneas específicas en tus bloques de código usando `highlight` con los números o rangos de líneas que quieres resaltar. + + + ```javascript Ejemplo de resaltado de líneas highlight= {1-2,5} + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + + ````mdx Formato + ```javascript highlight={1-2,5} + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + ```` + + +
+ ### Enfoque de líneas +
+ +Resalta líneas específicas en tus bloques de código usando `focus` con números de línea o rangos. + + + ```javascript Line focus example focus= {2,4-5} + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + + ````mdx Format + ```javascript focus={2,4-5} + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + ```` + + +
+ ### Mostrar números de línea +
+ +Muestra los números de línea en el lado izquierdo de tu bloque de código usando `lines`. + + + ```javascript Ejemplo: mostrar números de línea lines + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + + ````mdx Formato + ```javascript lines + const greeting = "Hello, World!"; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + ```` + + +
+ ### Expandible +
+ +Permite que los usuarios expandan y contraigan bloques de código largos usando `expandable`. + + + ```python Expandable example expandable + from datetime import datetime, timedelta + from typing import Dict, List, Optional + from dataclasses import dataclass + + @dataclass + class Book: + title: str + author: str + isbn: str + checked_out: bool = False + due_date: Optional[datetime] = None + + class Library: + def __init__(self): + self.books: Dict[str, Book] = {} + self.checkouts: Dict[str, List[str]] = {} # patron -> list of ISBNs + + def add_book(self, book: Book) -> None: + if book.isbn in self.books: + raise ValueError(f"Book with ISBN {book.isbn} already exists") + self.books[book.isbn] = book + + def checkout_book(self, isbn: str, patron: str, days: int = 14) -> None: + if patron not in self.checkouts: + self.checkouts[patron] = [] + + book = self.books.get(isbn) + if not book: + raise ValueError("Book not found") + + if book.checked_out: + raise ValueError("Book is already checked out") + + if len(self.checkouts[patron]) >= 3: + raise ValueError("Patron has reached checkout limit") + + book.checked_out = True + book.due_date = datetime.now() + timedelta(days=days) + self.checkouts[patron].append(isbn) + + def return_book(self, isbn: str) -> float: + book = self.books.get(isbn) + if not book or not book.checked_out: + raise ValueError("Book not found or not checked out") + + late_fee = 0.0 + if datetime.now() > book.due_date: + days_late = (datetime.now() - book.due_date).days + late_fee = days_late * 0.50 + + book.checked_out = False + book.due_date = None + + # Remove from patron's checkouts + for patron, books in self.checkouts.items(): + if isbn in books: + books.remove(isbn) + break + + return late_fee + + def search(self, query: str) -> List[Book]: + query = query.lower() + return [ + book for book in self.books.values() + if query in book.title.lower() or query in book.author.lower() + ] + + def main(): + library = Library() + + # Add some books + books = [ + Book("The Hobbit", "J.R.R. Tolkien", "978-0-261-10295-4"), + Book("1984", "George Orwell", "978-0-452-28423-4"), + ] + + for book in books: + library.add_book(book) + + # Checkout and return example + library.checkout_book("978-0-261-10295-4", "patron123") + late_fee = library.return_book("978-0-261-10295-4") + print(f"Late fee: ${late_fee:.2f}") + + if __name__ == "__main__": + main() + ``` + + ````text Format + ```python expandable + from datetime import datetime, timedelta + from typing import Dict, List, Optional + from dataclasses import dataclass + + # ... + + if __name__ == "__main__": + main() + ``` + ```` + + +
+ ### Ajuste +
+ +Activa el ajuste de texto para líneas largas con `wrap`. Esto evita el desplazamiento horizontal y facilita la lectura de líneas extensas. + + + ```javascript Wrap example wrap + const greeting = "Hello, World! I am a long line of text that will wrap to the next line."; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + + ````mdx Format + ```javascript wrap + const greeting = "Hello, World! I am a long line of text that will wrap to the next line."; + function sayHello() { + console.log(greeting); + } + sayHello(); + ``` + ```` + + +
+ ### Diff +
+ +Muestra un diff visual de las líneas agregadas o eliminadas en tus bloques de código. Las líneas agregadas se resaltan en verde y las eliminadas en rojo. + +Para crear diffs, agrega estos comentarios especiales al final de las líneas en tu bloque de código: + +* `// [!code ++]`: Marca una línea como agregada (resaltado en verde). +* `// [!code --]`: Marca una línea como eliminada (resaltado en rojo). + +Para varias líneas consecutivas, especifica la cantidad de líneas después de dos puntos: + +* `// [!code ++:3]`: Marca la línea actual más las dos siguientes como agregadas. +* `// [!code --:5]`: Marca la línea actual más las cuatro siguientes como eliminadas. + +La sintaxis de comentarios debe corresponder a tu lenguaje de programación (por ejemplo, `//` para JavaScript o `#` para Python). + + + ```js Ejemplo de líneas con diff + const greeting = "Hello, World!"; // [!code ++] + function sayHello() { + console.log("Hello, World!"); // [!code --] + console.log(greeting); // [!code ++] + } + sayHello(); + ``` + + ````text Formato + ```js lines + const greeting = "Hello, World!"; // [!code ++] + function sayHello() { + console.log("Hello, World!"); // [!code --] + console.log(greeting); // [!code ++] + } + sayHello(); + ``` + ```` + \ No newline at end of file diff --git a/es/create/files.mdx b/es/create/files.mdx new file mode 100644 index 000000000..5ec64333c --- /dev/null +++ b/es/create/files.mdx @@ -0,0 +1,96 @@ +--- +title: "Files" +description: "Sirve recursos estáticos desde tu documentación" +--- + +Mintlify sirve automáticamente recursos estáticos desde tu repositorio de documentación en la ruta correspondiente de tu domain. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`. + +Esto funciona para cualquier tipo de archivo que quieras poner a disposición de tus usuarios, incluidos imágenes, PDF, videos o esquemas. + +Los archivos deben tener menos de 20 MB si son imágenes y menos de 100 MB para otros tipos de archivos. + +
+ ## Extensiones de archivo compatibles +
+ +Mintlify admite las siguientes extensiones de archivo estático. + +
+ ### Formatos de imagen +
+ +- `.jpeg`, `.jpg`, `.jfif`, `.pjpeg`, `.pjp` +- `.png` +- `.svg`, `.svgz` +- `.ico` +- `.webp` +- `.gif`, `.apng` +- `.avif` +- `.bmp` +- `.tiff`, `.tif` + +
+ ### Formatos de vídeo +
+ +- `.mp4` +- `.webm` +- `.ogg` +- `.avi` +- `.mov` +- `.wmv` +- `.flv` +- `.mkv` +- `.m4v` + +
+ ### Formatos de audio +
+ +- `.mp3` +- `.wav` +- `.flac` +- `.aac` +- `.ogg` +- `.wma` +- `.m4a` + +
+ ### Formatos de documento +
+ +- `.pdf` +- `.txt` +- `.doc`, `.docx` +- `.xls`, `.xlsx` +- `.ppt`, `.pptx` +- `.rtf` +- `.odt`, `.ods`, `.odp` + +
+ ### Formatos de datos +
+ +- `.csv` +- `.tsv` +- `.xml` + +
+ ## Organización de archivos +
+ +Organiza tus archivos en carpetas para que tu repositorio sea fácil de navegar: + +```text +/your-project + |- docs.json + |- images/ + |- logo.png + |- screenshots/ + |- dashboard.png + |- assets/ + |- whitepaper.pdf + |- demo-video.mp4 +``` + +Los archivos se sirven desde la raíz de tu domain, por lo que la estructura de tu repositorio se corresponde directamente con la estructura de la URL. En el ejemplo anterior, `assets/whitepaper.pdf` estaría disponible en `https://docs.your-project.com/assets/whitepaper.pdf`. diff --git a/es/create/image-embeds.mdx b/es/create/image-embeds.mdx new file mode 100644 index 000000000..78950cc6d --- /dev/null +++ b/es/create/image-embeds.mdx @@ -0,0 +1,193 @@ +--- +title: "Imágenes y contenido incrustado" +description: "Agrega imágenes, videos e iframes" +--- + +Agrega imágenes, inserta videos e incluye contenido interactivo con iframes en tu documentación. + + + Fotografía de un paisaje con flores moradas en primer plano, montañas al fondo y un cielo azul con nubes dispersas. + + +
+ ## Imágenes +
+ +Agrega imágenes para aportar contexto visual, ejemplos o elementos decorativos a tu documentación. + +
+ ### Sintaxis básica de imágenes +
+ +Utiliza la [sintaxis de Markdown](https://www.markdownguide.org/basic-syntax/#images) para añadir imágenes a tu documentación: + +```mdx +![Texto alternativo que describe la imagen](/path/to/image.png) +``` + + + Incluye siempre texto alternativo descriptivo para mejorar la accesibilidad y el SEO. El texto alternativo debe describir claramente lo que muestra la imagen. + + +Los archivos de imagen deben pesar menos de 20 MB. Para archivos más grandes, alójalos en un servicio CDN como [Amazon S3](https://aws.amazon.com/s3) o [Cloudinary](https://cloudinary.com). + +
+ ### Inserciones de imágenes en HTML +
+ +Para tener más control sobre la visualización de imágenes, usa etiquetas HTML ``: + +```html +Interfaz principal del dashboard +``` + +
+ #### Desactivar la función de zoom +
+ +Para desactivar el zoom predeterminado al hacer clic en las imágenes, agrega la propiedad `noZoom`: + +```html highlight="4" +Texto alternativo descriptivo +``` + + + +Para convertir una imagen en un enlace clicable, envuélvela en una etiqueta de ancla y añade la propiedad `noZoom`: + +```html + + Logo de Mintlify + +``` + + + Las imágenes dentro de etiquetas de anclaje muestran automáticamente un cursor de puntero para indicar que se puede hacer clic en ellas. + + +
+ #### Imágenes para los modos claro y oscuro +
+ +Para mostrar imágenes distintas en los temas claro y oscuro, usa clases de Tailwind CSS: + +```html + +Interfaz en modo claro + + +Interfaz en modo oscuro +``` + +
+ ## Videos +
+ +Mintlify admite [etiquetas HTML en Markdown](https://www.markdownguide.org/basic-syntax/#html), lo que te brinda flexibilidad para crear contenido enriquecido. + + + Incluye siempre texto alternativo dentro de los elementos de video para los navegadores que no admiten la reproducción de video. + + +
+ ### Inserciones de YouTube +
+ +Inserta videos de YouTube usando elementos iframe: + +```html + +``` + + + +``` + + + + + Aprende a usar el componente Frame para presentar imágenes. + \ No newline at end of file diff --git a/es/create/list-table.mdx b/es/create/list-table.mdx new file mode 100644 index 000000000..90bd0175a --- /dev/null +++ b/es/create/list-table.mdx @@ -0,0 +1,91 @@ +--- +title: "Listas y tablas" +description: "Mostrar información en listas y tablas" +--- + +
+ ## Listas +
+ +Las listas siguen la sintaxis oficial de [Markdown](https://www.markdownguide.org/basic-syntax/#lists-1). + +
+ ### Lista ordenada +
+ +Para crear una lista ordenada, agrega números seguidos de un punto antes de cada elemento. + +1. Primer elemento +2. Segundo elemento +3. Tercer elemento +4. Cuarto elemento + +```mdx +1. Primer elemento +2. Segundo elemento +3. Tercer elemento +4. Cuarto elemento +``` + + +
+ ### Lista sin orden +
+ +Para crear una lista sin orden, agrega guiones (`-`), asteriscos (`*`) o signos más (`+`) antes de los elementos de la lista. + +* Primer elemento +* Segundo elemento +* Tercer elemento +* Cuarto elemento + +```mdx +- Primer elemento +- Segundo elemento +- Tercer elemento +- Cuarto elemento +``` + + +
+ ### Lista anidada +
+ +Sangra los elementos de la lista para anidarlos. + +* Primer elemento +* Segundo elemento + * Elemento adicional + * Elemento adicional +* Tercer elemento + +```mdx +- Primer elemento +- Segundo elemento + - Elemento adicional + - Elemento adicional +- Tercer elemento +``` + + +
+ ## Tablas +
+ +Las tablas siguen la [sintaxis oficial de Markdown](https://www.markdownguide.org/extended-syntax/#tables). + +Para añadir una tabla, usa tres o más guiones (`---`) para crear el encabezado de cada columna y usa barras verticales (`|`) para separar cada columna. Por compatibilidad, también debes añadir una barra vertical al principio y al final de cada fila. + +| Propiedad | Descripción | +| --------- | ------------------------------------ | +| Nombre | Nombre completo del usuario | +| Edad | Edad indicada | +| Ingreso | Si el usuario se unió a la comunidad | + +```mdx +| Property | Descripción | +| -------- | ------------------------------------- | +| Name | Nombre completo del usuario | +| Age | Edad reportada | +| Joined | Si el usuario se unió a la comunidad | +``` diff --git a/es/create/reusable-snippets.mdx b/es/create/reusable-snippets.mdx new file mode 100644 index 000000000..58cbb84e5 --- /dev/null +++ b/es/create/reusable-snippets.mdx @@ -0,0 +1,132 @@ +--- +title: 'Fragmentos reutilizables' +description: 'Fragmentos personalizados reutilizables para mantener el contenido sincronizado' +--- + +Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself), que también aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para mantener tu contenido sincronizado. + +
+ ## Creación de un fragmento personalizado +
+ +**Requisito previo**: Debes crear tu archivo de fragmento en el directorio `snippets` para que la importación funcione. + +Cualquier página en el directorio `snippets` se tratará como un fragmento y no +se renderizará como una página independiente. Si deseas crear una página independiente +a partir del fragmento, importa el fragmento en otro archivo e invócalo como un +componente. + +
+ ### Exportación por defecto +
+ +1. Agrega contenido al archivo del fragmento que quieras reutilizar. Opcionalmente, puedes agregar variables que se puedan completar mediante props + cuando importes el fragmento. En este ejemplo, nuestra variable es word. + +```typescript snippets/my-snippet.mdx +¡Hola mundo! Este es mi contenido que quiero reutilizar en todas las páginas. +``` + +2. Importa el fragmento en tu archivo de destino. + +```typescript destination-file.mdx +--- +title: Mi título +description: Mi descripción +--- + +import MySnippet from '/snippets/path/to/my-snippet.mdx'; + +## Encabezado + +Lorem ipsum dolor sit amet. + + + +``` + +
+ ### Exportación con variables +
+ +1. Opcionalmente, puedes añadir variables que se puedan completar mediante props cuando importes el fragmento. En este ejemplo, nuestra variable es word. + +```typescript snippets/my-snippet.mdx +Mi palabra clave del día es {word}. +``` + +2. Importa el fragmento en tu archivo de destino con la variable. La propiedad se completará según tu configuración. + +```typescript destination-file.mdx +--- +title: Mi título +description: Mi descripción +--- + +import MySnippet from '/snippets/path/to/my-snippet.mdx'; + +## Encabezado + +Lorem ipsum dolor sit amet. + + + +``` + +
+ ### Variables reutilizables +
+ +1. Exporta una variable desde tu archivo de fragmento: + +```typescript snippets/path/to/custom-variables.mdx +export const myName = 'mi nombre'; + +export const myObject = { fruit: 'fresas' }; +``` + +2. Importa el fragmento desde el archivo de destino y usa la variable: + +```typescript destination-file.mdx +--- +title: Mi título +description: Mi descripción +--- + +import { myName, myObject } from '/snippets/path/to/custom-variables.mdx'; + +Hola, mi nombre es {myName} y me gusta {myObject.fruit}. +``` + +
+ ### Fragmentos de JSX +
+ +1. Exporta un componente JSX desde tu archivo de fragmento. (Consulta [Componentes de React](/es/customize/react-components) para obtener más información): + +```js icon=square-js snippets/my-jsx-snippet.jsx +export const MyJSXSnippet = () => { + return ( +
+

¡Hola, mundo!

+
+ ) +} +``` + + + Importante: Al crear fragmentos de JSX, usa la sintaxis de funciones flecha (`=>`) en lugar de declaraciones de función. La palabra clave `function` no es compatible en este contexto. + + +2. Importa el fragmento desde tu archivo de destino y utiliza el componente: + +```typescript destination-file.mdx +--- +title: Mi título +description: Mi descripción +--- + +import { MyJSXSnippet } from '/snippets/my-jsx-snippet.jsx'; + + +``` diff --git a/es/create/text.mdx b/es/create/text.mdx new file mode 100644 index 000000000..6e545ad5a --- /dev/null +++ b/es/create/text.mdx @@ -0,0 +1,283 @@ +--- +title: "Dar formato al texto" +description: "Aprende a dar formato al texto, crear encabezados y dar estilo al contenido" +--- + +
+ ## Encabezados +
+ +Los encabezados organizan tu contenido y crean anclajes de navegación. Aparecen en la tabla de contenidos y ayudan a los usuarios a explorar tu documentación. + +
+ ### Creación de encabezados +
+ +Usa los símbolos `#` para crear encabezados de distintos niveles: + +```mdx +## Encabezado de sección principal +### Encabezado de subsección +#### Encabezado de sub-subsección +``` + + + Utiliza encabezados descriptivos, con palabras clave, que indiquen claramente el contenido que sigue. Esto mejora la navegación del usuario y el posicionamiento en buscadores. + + + + +De forma predeterminada, los encabezados incluyen enlaces de anclaje en los que se puede hacer clic que permiten a los usuarios enlazar directamente a secciones específicas. Puedes desactivar estos enlaces de anclaje usando la prop `noAnchor` en encabezados HTML o React. + + + ```mdx HTML header example +

+ Encabezado sin enlace de anclaje +

+ ``` + + ```mdx React header example + + Encabezado sin enlace de anclaje + + ``` +
+ +Cuando se usa `noAnchor`, el encabezado no mostrará la “píldora” de anclaje y, al hacer clic en el texto del encabezado, no se copiará el enlace de anclaje al portapapeles. + +
+ ## Formato de texto +
+ +Compatible con la mayoría del formato de Markdown para resaltar y dar estilo al texto. + +
+ ### Formato básico +
+ +Aplica estos estilos de formato a tu texto: + +| Estilo | Sintaxis | Ejemplo | Resultado | +|-------|--------|---------|--------| +| **Negrita** | `**text**` | `**nota importante**` | **nota importante** | +| *Cursiva* | `_text_` | `_énfasis_` | *énfasis* | +| ~~Tachado~~ | `~text~` | `~función en desuso~` | ~~función en desuso~~ | + +
+ ### Combinar formatos +
+ +Puedes combinar estilos de formato: + +```mdx +**_negrita y cursiva_** +**~~negrita y tachado~~** +*~~cursiva y tachado~~** +``` + +***negrita y cursiva***
+**~~negrita y tachado~~**
+*~~cursiva y tachado~~* + +
+ ### Superíndice y subíndice +
+ +Para expresiones matemáticas o notas al pie, usa etiquetas HTML: + +| Tipo | Sintaxis | Ejemplo | Resultado | +|------|--------|---------|--------| +| Superíndice | `text` | `example2` | example2 | +| Subíndice | `text` | `examplen` | examplen | + + + +Los enlaces ayudan a los usuarios a navegar entre páginas y acceder a recursos externos. Usa texto de enlace descriptivo para mejorar la accesibilidad y la experiencia del usuario. + + + +Vincula otras páginas de tu documentación usando rutas relativas a la raíz: + +```mdx +[Inicio rápido](/quickstart) +[Pasos](/components/steps) +``` + +[Inicio rápido](/es/quickstart)
+[Pasos](/es/components/steps) + + + Evita los enlaces relativos como `[page](../page)`, ya que se cargan más lentamente y no pueden optimizarse tan eficazmente como los enlaces relativos a la raíz. + + + + +Para los recursos externos, incluye la URL completa: + +```mdx +[Guía de Markdown](https://www.markdownguide.org/) +``` + +[Guía de Markdown](https://www.markdownguide.org/) + + + +Puedes comprobar si hay enlaces rotos en tu documentación usando la [CLI](/es/installation): + +```bash +mint enlaces-rotos +``` + +
+ ## Citas en bloque +
+ +Las citas en bloque destacan información importante, citas o ejemplos dentro de tu contenido. + +
+ ### Citas en bloque de una sola línea +
+ +Agrega `>` antes del texto para crear una cita en bloque: + +```mdx +> Esta es una cita que se destaca del contenido principal. +``` + +> Esta es una cita que destaca del contenido principal. + +
+ ### Citas en bloque de varias líneas +
+ +Para citas largas o de varios párrafos: + +```mdx +> Este es el primer párrafo de una cita en bloque de múltiples líneas. +> +> Este es el segundo párrafo, separado por una línea vacía con `>`. +``` + +> Este es el primer párrafo de una cita en bloque de varias líneas. +> +> Este es el segundo párrafo, separado por una línea en blanco con `>`. + + + Usa las citas en bloque con moderación para mantener su impacto visual y su significado. Considera usar [llamadas](/es/components/callouts) para notas, advertencias y otra información. + + +
+ ## Expresiones matemáticas +
+ +Compatibilizamos LaTeX para representar expresiones y ecuaciones matemáticas. + +
+ ### Matemáticas en línea +
+ +Usa un solo signo de dólar, `$`, para expresiones matemáticas en línea: + +```mdx +El teorema de Pitágoras establece que $(a^2 + b^2 = c^2)$ en un triángulo rectángulo. +``` + +El teorema de Pitágoras establece que $(a^2 + b^2 = c^2)$ en un triángulo rectángulo. + +
+ ### Ecuaciones en bloque +
+ +Usa dos signos de dólar, `$$`, para ecuaciones en bloque: + +```mdx +$$ +E = mc^2 +$$ +``` + +$$ +E = mc^2 +$$ + + + La compatibilidad con LaTeX requiere una sintaxis matemática correcta. Consulta la [documentación de LaTeX](https://www.latex-project.org/help/documentation/) para obtener pautas completas sobre la sintaxis. + + +
+ ## Saltos de línea y espaciado +
+ +Controla los saltos de línea y el espaciado para mejorar la legibilidad del contenido. + +
+ ### Saltos de párrafo +
+ +Separe los párrafos con líneas en blanco: + +```mdx +Este es el primer párrafo. + +Este es el segundo párrafo, separado por una línea en blanco. +``` + +Este es el primer párrafo. + +Este es el segundo párrafo, separado por una línea en blanco. + +
+ ### Saltos de línea manuales +
+ +Usa etiquetas HTML `
` para forzar saltos de línea dentro de párrafos: + +```mdx +Esta línea termina aquí.
+Esta línea comienza en una nueva línea. +``` + +Esta línea termina aquí.
+Esta línea comienza en una línea nueva. + + + En la mayoría de los casos, separar los párrafos con líneas en blanco ofrece mejor legibilidad que insertar saltos de línea manuales. + + +
+ ## Buenas prácticas +
+ +
+ ### Organización del contenido +
+ +* Usa encabezados para crear una jerarquía de contenido clara +* Respeta la jerarquía correcta de encabezados (no saltes de H2 a H4) +* Escribe encabezados descriptivos con palabras clave + +
+ ### Formato de texto +
+ +* Usa la negrita para enfatizar, no para párrafos completos +* Reserva la cursiva para términos, títulos o un énfasis sutil +* Evita el exceso de formato que distraiga del contenido + + + +* Usa texto de enlace descriptivo en lugar de “haz clic aquí” o “leer más” +* Utiliza rutas relativas a la raíz para los enlaces internos +* Revisa los enlaces con regularidad para evitar referencias rotas \ No newline at end of file diff --git a/es/customize/custom-404-page.mdx b/es/customize/custom-404-page.mdx new file mode 100644 index 000000000..50b367a9b --- /dev/null +++ b/es/customize/custom-404-page.mdx @@ -0,0 +1,45 @@ +--- +title: "Página 404 personalizada" +description: "Personaliza el título y la descripción de tu página de error 404" +--- + +Puedes controlar el título y la descripción de la página de error 404 que aparece cuando los usuarios llegan a enlaces rotos o inexistentes. + +Al personalizar tu página 404, usa la descripción para orientar a los usuarios hacia recursos útiles o enlaces en tu documentación que les ayuden a encontrar lo que buscan. + +
+ ## Configuración +
+ +Configura la página 404 en la sección `errors.404` de tu archivo `docs.json`: + +```json +"errors": { + "404": { + "redirect": false, + "title": "No se puede encontrar", + "description": "¿Qué **pasó** con esta _página_?" + } +} +``` + + +
+ ## Parámetros +
+ + + Si se debe redirigir automáticamente a la página de inicio cuando no se encuentra una página. + + Configúralo en `true` para redirigir a la página de inicio. + + Configúralo en `false` para mostrar la página 404 personalizada. + + + + Título personalizado para la página de error 404. Reemplaza el encabezado predeterminado “Page not found”. + + + + Descripción personalizada para la página de error 404. Admite formato Markdown. + \ No newline at end of file diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx new file mode 100644 index 000000000..684446cbc --- /dev/null +++ b/es/customize/custom-domain.mdx @@ -0,0 +1,54 @@ +--- +title: "Custom domain" +description: "Aloja tu documentación en el domain personalizado de tu sitio web" +--- + +Para configurar tu documentación en un domain personalizado, debes establecer el domain personalizado que desees en la configuración de Mintlify y ajustar la configuración de DNS en el proveedor de tu domain. + + + ¿Quieres configurar un subdirectorio personalizado como `mintlify.com/docs`? Consulta la documentación sobre [subdirectorios personalizados](/es/deploy/cloudflare). + + +
+ ## Configuración del dashboard +
+ +1. Ve a tu [dashboard](https://dashboard.mintlify.com) +2. Selecciona **Settings** +3. Selecciona **Domain Setup** +4. Ingresa el dominio personalizado que deseas. Por ejemplo, `docs.mintlify.com` + + + Dominio personalizado + + Dominio personalizado + + +
+ ## Configurar tu DNS +
+ +1. Ve a la configuración de DNS de tu dominio en el sitio web de tu proveedor de dominio. +2. Crea una nueva entrada de DNS e introduce los siguientes valores: + +```bash +CNAME | docs | cname.vercel-dns.com. +``` + + + DNS + + +
+ ## Configuraciones específicas del proveedor +
+ + + + Si Vercel es tu proveedor de dominio, debes agregar un registro `TXT` de verificación. Esta información aparecerá en tu dashboard después de enviar tu dominio personalizado y también se te enviará por correo electrónico. + + + + Si Cloudflare es tu proveedor de DNS, debes habilitar la opción de seguridad “full strict” en la configuración de HTTPS. + + \ No newline at end of file diff --git a/es/customize/custom-scripts.mdx b/es/customize/custom-scripts.mdx new file mode 100644 index 000000000..7323a0cd3 --- /dev/null +++ b/es/customize/custom-scripts.mdx @@ -0,0 +1,194 @@ +--- +title: "Scripts personalizados" +description: "Personaliza por completo tu documentación con CSS y JS personalizados" +--- + +Usa CSS para dar estilo a los elementos HTML o agrega CSS y JavaScript personalizados para ajustar por completo la apariencia y la experiencia de tu documentación. + +
+ ## Estilizado con Tailwind CSS +
+ +Usa Tailwind CSS v3 para dar estilo a elementos HTML. Puedes controlar el diseño, el espaciado, los colores y otras propiedades visuales. Algunas clases comunes son: + +* `w-full` - Ancho completo +* `aspect-video` - Relación de aspecto 16:9 +* `rounded-xl` - Esquinas redondeadas grandes +* `block`, `hidden` - Control de visualización +* `dark:hidden`, `dark:block` - Visibilidad en modo oscuro + +Los valores arbitrarios de Tailwind CSS no están admitidos. Para valores personalizados, usa la prop `style`. + +```html + +``` + + +
+ ## CSS personalizado +
+ +Agrega archivos CSS a tu repositorio y los nombres de clase definidos se aplicarán y estarán disponibles en todos tus archivos `MDX`. + +
+ ### Agregar `style.css` +
+ +Por ejemplo, puedes agregar el siguiente archivo `style.css` para personalizar el estilo de la barra de navegación y el pie de página. + +```css +#navbar { + background: "#fffff2"; + padding: 1rem; +} + +footer { + margin-top: 2rem; +} +``` + + +
+ ### Uso de identificadores y selectores +
+ +Mintlify cuenta con un conjunto de identificadores y selectores comunes para ayudarte a etiquetar elementos importantes de la interfaz. + + + Usa Inspeccionar elemento para encontrar referencias a los elementos que quieres personalizar. + + + + + - APIPlaygroundInput: `api-playground-input` + - AssistantEntry: `assistant-entry` + - AssistantEntryMobile: `assistant-entry-mobile` + - Banner: `banner` + - ChangelogFilters: `changelog-filters` + - ChangelogFiltersContent: `changelog-filters-content` + - ChatAssistantSheet: `chat-assistant-sheet` + - ChatAssistantTextArea: `chat-assistant-textarea` + - ContentArea: `content-area` + - ContentContainer: `content-container` + - ContentSideLayout: `content-side-layout` + - Footer: `footer` + - Header: `header` + - NavBarTransition: `navbar-transition` + - NavigationItems: `navigation-items` + - Navbar: `navbar` + - PageContextMenu: `page-context-menu` + - PageContextMenuButton: `page-context-menu-button` + - PageTitle: `page-title` + - Paginación: `pagination` + - Panel: `panel` + - RequestExample: `request-example` + - ResponseExample: `response-example` + - SearchBarEntry: `search-bar-entry` + - SearchBarEntryMobile: `search-bar-entry-mobile` + - SearchInput: `search-input` + - Sidebar: `sidebar` + - SidebarContent: `sidebar-content` + - TableOfContents: `table-of-contents` + - TableOfContentsContent: `table-of-contents-content` + - TableOfContentsLayout: `table-of-contents-layout` + - TopbarCtaButton: `topbar-cta-button` + + + - Accordion: `accordion` + - AccordionGroup: `accordion-group` + - AlmondLayout: `almond-layout` + - AlmondNavBottomSection: `almond-nav-bottom-section` + - AlmondNavBottomSectionDivider: `almond-nav-bottom-section-divider` + - Anchor: `nav-anchor` + - Anchors: `nav-anchors` + - APISection: `api-section` + - APISectionHeading: `api-section-heading` + - APISectionHeadingSubtitle: `api-section-heading-subtitle` + - APISectionHeadingTitle: `api-section-heading-title` + - Callout: `callout` + - Card: `card` + - CardGroup: `card-group` + - ChatAssistantSheet: `chat-assistant-sheet` + - ChatAssistantSheetHeader: `chat-assistant-sheet-header` + - ChatAssistantSheetContent: `chat-assistant-sheet-content` + - ChatAssistantInput: `chat-assistant-input` + - ChatAssistantSendButton: `chat-assistant-send-button` + - CodeBlock: `code-block` + - CodeGroup: `code-group` + - Content: `mdx-content` + - DropdownTrigger: `nav-dropdown-trigger` + - DropdownContent: `nav-dropdown-content` + - DropdownItem: `nav-dropdown-item` + - DropdownItemTextContainer: `nav-dropdown-item-text-container` + - DropdownItemTitle: `nav-dropdown-item-title` + - DropdownItemDescription: `nav-dropdown-item-description` + - DropdownItemIcon: `nav-dropdown-item-icon` + - Expandable: `expandable` + - Eyebrow: `eyebrow` + - FeedbackToolbar: `feedback-toolbar` + - Field: `field` + - Frame: `frame` + - Icon: `icon` + - Link: `link` + - LoginLink: `login-link` + - Logo: `nav-logo` + - Mermaid: `mermaid` + - MethodNavPill: `method-nav-pill` + - MethodPill: `method-pill` + - NavBarLink: `navbar-link` + - NavTagPill: `nav-tag-pill` + - NavTagPillText: `nav-tag-pill-text` + - OptionDropdown: `option-dropdown` + - PaginationNext: `pagination-next` + - PaginationPrev: `pagination-prev` + - PaginationTitle: `pagination-title` + - Panel: `panel` + - SidebarGroup: `sidebar-group` + - SidebarGroupIcon: `sidebar-group-icon` + - SidebarGroupHeader: `sidebar-group-header` + - SidebarNavGroupDivider: `sidebar-nav-group-divider` + - SidebarTitle: `sidebar-title` + - Step: `step` + - Steps: `steps` + - Tab: `tab` + - Tabs: `tabs` + - TabsBar: `nav-tabs` + - TabsBarItem: `nav-tabs-item` + - TableOfContents: `toc` + - TableOfContentsItem: `toc-item` + - Tooltip: `tooltip` + - TopbarRightContainer: `topbar-right-container` + - TryitButton: `tryit-button` + - Update: `update` + + + + + Las referencias y el estilo de los elementos comunes pueden cambiar a medida que la plataforma evoluciona. Utiliza estilos personalizados con precaución. + + +
+ ## JavaScript personalizado +
+ +El JavaScript personalizado te permite agregar código ejecutable a nivel global. Es equivalente a insertar una etiqueta `