Routage & Internationalisation

AstroGlass utilise le système de routage basé sur les fichiers d’Astro combiné à une stratégie de personnalisation internationale (i18n).

Routage de Page

Les pages sont situées dans src/pages/. La structure des dossiers détermine le chemin de l’URL.

Pour les pages localisées, nous utilisons des répertoires distincts :

Routage des Démos de Thèmes

Les pages de thèmes sont générées dynamiquement à partir du registre des thèmes. L’ajout d’un thème à src/config/themes.ts avec enabled: true crée automatiquement une route vers /{themeId}.

Routage de la Documentation

Les pages de documentation se trouvent dans src/content/docs/[lang]/ :

L’URL de la documentation est automatiquement générée en fonction du chemin du fichier, par ex., /docs/fr/getting-started/introduction.

Internationalisation (i18n)

Les traductions sont gérées de deux manières :

1. Routage de Page Dynamique : Un répertoire centralisé src/pages/[...lang]/ gère dynamiquement toutes les permutations de routes via getStaticPaths().
2. Chaînes de l’Interface Utilisateur (UI) : Fichiers JSON centralisés dans src/locales/.

Traductions de l’Interface Utilisateur (UI)

Les chaînes communes (éléments de navigation, boutons, texte de section, etc.) sont stockées sous forme de fichiers JSON organisés par section :

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

Utilisez l’assistant useTranslations dans les composants :

---
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>

Les clés de traduction supportent la notation par points pour les valeurs imbriquées. Les clés de common.json sont distribuées au niveau racine, tandis que les autres fichiers sont espacés par leur nom de fichier (par ex., hero.title, pricing.plans).

Ajouter une Nouvelle Langue