Enrutamiento e Internacionalización

AstroGlass utiliza el sistema de enrutamiento basado en archivos de Astro combinado con una estrategia personalizada de internacionalización (i18n).

Enrutamiento de Páginas

Las páginas están ubicadas en src/pages/. La estructura de carpetas determina la ruta de la URL.

Para las páginas localizadas, usamos directorios separados:

Enrutamiento de Demostración de Temas

Las páginas de temas se generan dinámicamente desde el registro de temas. Agregar un tema a src/config/themes.ts con enabled: true crea automáticamente una ruta en /{themeId}.

Enrutamiento de Documentación

Las páginas de documentación viven en src/content/docs/[lang]/:

La URL para la documentación se genera automáticamente en función a la ruta del archivo, por ej., /docs/es/getting-started/introduction.

Internacionalización (i18n)

Las traducciones se manejan de dos formas:

1. Enrutamiento de Páginas Dinámico: Un directorio centralizado src/pages/[...lang]/ maneja todas las permutaciones de rutas dinámicamente mediante getStaticPaths().
2. Cadenas de UI: Archivos JSON centralizados en src/locales/.

Traducciones de Interfaz (UI)

Las cadenas comunes (elementos de navegación, botones, texto de sección, etc.) se almacenan como archivos JSON organizados por sección:

src/locales/
├── en/
├── ru/
├── fr/
├── es/
├── ja/
├── zh/
└── kk/

Utilice el asistente useTranslations en los componentes:

---
import { useTranslations } from '../utils/i18n';
import { getLocaleFromUrl } from '../utils/locale-utils';

const locale = getLocaleFromUrl(Astro.url);
const t = useTranslations(locale);
---
<p>{t('hero.title')}</p>
<p>{t('pricing.tier2Name')}</p>

Las claves de traducción soportan notación de puntos (dot notation) para valores anidados. Las claves del archivo common.json se extienden en el nivel raíz, mientras que los otros archivos tienen espacios de nombres según el nombre de su archivo (por ejemplo, hero.title, pricing.plans).

Agregar un Nuevo Idioma