توثيق تكامل Astro intlayer

يقوم تكامل intlayer لـ Astro بتهيئة مشروعك للتدويل متعدد اللغات (i18n). حيث يتولى إعداد القواميس أثناء البناء، وحقن إضافات Vite، والتسجيل التلقائي لبرمجية الطلب الوسيطة، وإخراج الصفحات المعروضة مسبقًا والمترجمة.

الاستخدام

أضف intlayer() إلى ملف astro.config.mjs:

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

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

ينشئ أمر Astro CLI codemod (astro add astro-intlayer) أيضًا استيرادًا افتراضيًا مدعومًا:

import intlayer from "astro-intlayer";

الوصف

يرتبط التكامل بدورة حياة البناء والتشغيل في Astro:

1. إعداد التهيئة (astro:config:setup):
   • إعداد القواميس: يجهز قواميس Intlayer والأنواع المنشأة قبل بدء عملية البناء.
   • إضافات Vite: يحقن إضافات لأسماء Vite المستعارة (مما يتيح استيراد القواميس بسلاسة)، ووكلاء توجيه اللغة، وتقليم البناء.
   • تسجيل البرمجية الوسيطة: يحقن تلقائيًا astro-intlayer/middleware في سلسلة برمجيات مشروعك الوسيطة، ويملأ Astro.locals.intlayer مع كل طلب وارد.
2. اكتمال البناء (astro:build:done):
   • إعادة كتابة الصفحات: يفحص قواعد إعادة كتابة عناوين URL المترجمة ويُخرج صفحات HTML المعروضة مسبقًا في مساراتها المترجمة المناسبة.

ما يتم توفيره افتراضيًا

بمجرد التهيئة، يمكن لتطبيق Astro الخاص بك استخدام ما يلي مباشرة:

• خطافات useIntlayer و useDictionary و useLocale داخل واجهة مكونات .astro.
• كائن Astro.locals.intlayer في نقاط النهاية وصفحات Astro.
• استيرادات جانب العميل في كتل <script> التي تعكس نفس واجهة برمجة التطبيقات مع تحديثات تفاعلية.
• أدوات التنسيق المضمنة ضمن astro-intlayer/format (useDate و useNumber و useCurrency إلخ).

المستندات ذات الصلة

• خطاف useIntlayer
• خطاف useLocale
• البرمجية الوسيطة onRequest