{"schemaVersion":1,"title":"Versiones e idiomas","url":"https://appgram.github.io/docsy/versions/current/es/guides/tutorials/versions-and-locales","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/es/guides/tutorials/versions-and-locales","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/es/guides/tutorials/versions-and-locales.json","version":"current","locale":"es","markdown":"# Versiones e idiomas\n\nPrueba los selectores, las variantes de los artículos y el contenido en inglés cuando falta una traducción.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nEste portal ofrece dos versiones (**Current** y **Preview (demo)**) y tres idiomas (**English**, **Français** y **Español**). Los selectores situados encima del artículo cambian el contexto y conservan la página cuando existe en el destino.\n\n> Una demostración, no una nueva versión del producto\n>\n> Preview contiene una guía de inicio diferente para comprobar las variantes. Los demás artículos se comparten entre versiones. No anuncia futuras funciones.\n\n## Probar las combinaciones\n\n1. Abre **Primeros pasos** con Current y Español seleccionados.\n2. Elige **Preview (demo)**: cambian el título y el contenido de la guía.\n3. Elige **English** o **Français**: Preview sigue seleccionado, pero cambia el idioma.\n4. Vuelve a **Current** y **Español** para recuperar la guía actual en español.\n\n| Contexto | Ruta |\n| --- | --- |\n| Current / English | `/docsy/guides/getting-started` |\n| Current / Español | `/docsy/versions/current/es/guides/getting-started` |\n| Preview / Español | `/docsy/versions/preview/es/guides/getting-started` |\n\n## Configurar versiones e idiomas\n\n```yaml\nversions:\n  default: current\n  items:\n    - id: current\n      label: Current\n    - id: preview\n      label: Preview (demo)\n      status: beta\nlocalization:\n  defaultLocale: en\n  fallback: true\n  locales:\n    - code: en\n      label: English\n    - code: fr\n      label: Français\n    - code: es\n      label: Español\n```\n\nLa combinación predeterminada conserva las URL habituales. Las demás usan `/versions/{version}/{locale}` después de la ruta base del sitio. Un idioma también puede declarar `dir: rtl` para una escritura de derecha a izquierda.\n\n## Registrar variantes de un artículo\n\n```yaml\ncontent:\n  articles:\n    - slug: getting-started\n      source: content/getting-started.md\n      title: Get started with Docsy\n    - slug: getting-started\n      locale: es\n      source: content/es/getting-started.md\n      title: Primeros pasos con Docsy\n    - slug: getting-started\n      version: preview\n      locale: es\n      source: content/preview/es/getting-started.md\n      title: Primeros pasos — espacio de demostración\n```\n\nSin `version`, un artículo se comparte entre versiones. Sin `locale`, pertenece al idioma predeterminado. Para cada artículo, Docsy selecciona primero las variantes específicas de la versión, o las compartidas si no existen. Después busca el idioma solicitado y, si se permite, el idioma predeterminado.\n\n## Comprobar el contenido alternativo en inglés\n\nCon Español seleccionado, abre **Configuración YAML** o **Búsqueda y API para agentes**. Estos artículos todavía no tienen traducción al español. El cuerpo sigue en inglés y un aviso lo explica. La navegación y los selectores conservan el contexto español.\n\nCon `fallback: false`, los artículos sin traducción dejan de aparecer en ese idioma en lugar de mostrar el texto inglés.\n\n## Traducir la interfaz y consultar las exportaciones\n\nLas etiquetas de navegación usan `titles.es`; la portada usa `home.translations.es`; los textos de la interfaz usan `localization.messages.es`. Las traducciones se escriben en el repositorio. Docsy no envía los artículos a un servicio externo de traducción.\n\nLas exportaciones Markdown y JSON corresponden a la versión y al idioma seleccionados. Si un artículo usa el contenido alternativo en inglés, `contentLocale` indica `en` e `isFallback` vale `true`. La búsqueda solo incluye registros del contexto seleccionado.\n\n","contentLocale":"es","isFallback":false,"authorship":{"authors":[{"name":"nedimf","kind":"human","github":"nedimf","avatar":"/docsy/assets/authors/nedimf.png","role":"AppGram","id":"nedimf","url":"https://github.com/nedimf"},{"name":"AppGram","kind":"organization","github":"AppGram","url":"https://appgram.dev","avatar":"/docsy/assets/ag-logo.svg","id":"appgram"}],"contributors":[],"reviewedBy":[]},"editUrl":"https://github.com/AppGram/docsy/edit/main/content/es/versions-and-locales.md"}