Dokumentasi Integrasi Astro intlayer

Integrasi intlayer untuk Astro mengonfigurasi proyek Anda untuk internasionalisasi multibahasa (i18n). Integrasi ini menangani persiapan kamus saat build, injeksi plugin Vite, pendaftaran middleware permintaan otomatis, serta pembuatan halaman prerender yang dilokalisasi.

Penggunaan

Tambahkan intlayer() ke astro.config.mjs Anda:

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

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

Codemod Astro CLI (astro add astro-intlayer) juga menghasilkan impor default yang didukung:

import intlayer from "astro-intlayer";

Deskripsi

Integrasi terhubung ke dalam siklus proses build dan runtime Astro:

1. Konfigurasi Setup (astro:config:setup):
   • Persiapan Kamus: Menyiapkan kamus Intlayer dan tipe yang dihasilkan sebelum proses build berjalan.
   • Plugin Vite: Menyuntikkan plugin untuk alias Vite (memungkinkan impor kamus yang lancar), proksi perutean lokal, dan pemangkasan build.
   • Pendaftaran Middleware: Secara otomatis menyuntikkan astro-intlayer/middleware ke dalam rantai middleware proyek Anda, mengisi Astro.locals.intlayer pada setiap permintaan yang masuk.
2. Build Selesai (astro:build:done):
   • Penulisan Ulang Halaman: Memeriksa aturan penulisan ulang URL lokal dan menghasilkan halaman HTML yang diprerender di jalur lokal yang sesuai.

Apa yang Disediakan Secara Langsung

Setelah dikonfigurasi, aplikasi Astro Anda dapat langsung menggunakan:

• Hook useIntlayer, useDictionary, dan useLocale di dalam frontmatter komponen .astro.
• Objek Astro.locals.intlayer di endpoint dan halaman Astro.
• Impor sisi klien dalam blok <script> yang mencerminkan API yang sama dengan pembaruan reaktif.
• Formatter bawaan di bawah astro-intlayer/format (useDate, useNumber, useCurrency, dll.).

Dokumentasi Terkait

• Hook useIntlayer
• Hook useLocale
• Middleware onRequest