Este 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.
Probar las combinaciones
- Abre Primeros pasos con Current y Español seleccionados.
- Elige Preview (demo): cambian el título y el contenido de la guía.
- Elige English o Français: Preview sigue seleccionado, pero cambia el idioma.
- Vuelve a Current y Español para recuperar la guía actual en español.
| Contexto | Ruta |
|---|---|
| Current / English | /docsy/guides/getting-started |
| Current / Español | /docsy/versions/current/es/guides/getting-started |
| Preview / Español | /docsy/versions/preview/es/guides/getting-started |
Configurar versiones e idiomas
versions:
default: current
items:
- id: current
label: Current
- id: preview
label: Preview (demo)
status: beta
localization:
defaultLocale: en
fallback: true
locales:
- code: en
label: English
- code: fr
label: Français
- code: es
label: Español
La 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.
Registrar variantes de un artículo
content:
articles:
- slug: getting-started
source: content/getting-started.md
title: Get started with Docsy
- slug: getting-started
locale: es
source: content/es/getting-started.md
title: Primeros pasos con Docsy
- slug: getting-started
version: preview
locale: es
source: content/preview/es/getting-started.md
title: Primeros pasos — espacio de demostración
Sin 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.
Comprobar el contenido alternativo en inglés
Con 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.
Con fallback: false, los artículos sin traducción dejan de aparecer en ese idioma en lugar de mostrar el texto inglés.
Traducir la interfaz y consultar las exportaciones
Las 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.
Las 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.