Documentazione dell'integrazione Astro intlayer

L'integrazione intlayer per Astro configura il tuo progetto per l'internazionalizzazione (i18n) multilingue. Gestisce la preparazione dei dizionari in fase di compilazione, l'inserimento dei plugin Vite, la registrazione automatica del middleware di richiesta e l'emissione di pagine pre-renderizzate localizzate.

Utilizzo

Aggiungi intlayer() a astro.config.mjs:

import { defineConfig } from "astro/config";
import { intlayer } from "astro-intlayer";

export default defineConfig({
  integrations: [intlayer()],
});

Il codemod dell'Astro CLI (astro add astro-intlayer) genera anche un'importazione predefinita supportata:

import intlayer from "astro-intlayer";

Descrizione

L'integrazione si inserisce nel ciclo di vita di compilazione ed esecuzione di Astro:

1. Configurazione iniziale (astro:config:setup):
   • Preparazione dizionari: Prepara i dizionari Intlayer e i tipi generati prima dell'esecuzione della compilazione.
   • Plugin Vite: Inserisce i plugin per gli alias Vite (abilitando importazioni dirette dei dizionari), proxy di routing dei locale e rimozione degli elementi superflui della compilazione.
   • Registrazione middleware: Inserisce automaticamente astro-intlayer/middleware nella catena di middleware del progetto, popolando Astro.locals.intlayer a ogni richiesta in arrivo.
2. Compilazione completata (astro:build:done):
   • Riscritture di pagina: Ispeziona le regole di riscrittura degli URL localizzati ed emette pagine HTML pre-renderizzate nei rispettivi percorsi localizzati.

Cosa viene fornito out-of-the-box

Una volta configurata, la tua applicazione Astro può utilizzare immediatamente:

• Gli hook useIntlayer, useDictionary e useLocale nel frontmatter dei componenti .astro.
• L'oggetto Astro.locals.intlayer negli endpoint e nelle pagine Astro.
• Importazioni lato client nei blocchi <script> che rispecchiano la stessa API con aggiornamenti reattivi.
• Formattatori integrati sotto astro-intlayer/format (useDate, useNumber, useCurrency, ecc.).

Documentazione correlata

• Hook useIntlayer
• Hook useLocale
• Middleware onRequest