الترحيل من next-intl إلى Intlayer

للحصول على برنامج تعليمي مفصل وكامل خطوة بخطوة، يرجى مراجعة دليل الترحيل الكامل من next-intl.

يسمح الترحيل من next-intl إلى Intlayer بالحفاظ على التوجيه والصيغة الخاصة بتطبيقك دون تضرر.

ما يجب فعله

قم بتنفيذ الأمر التالي في المستودع الخاص بك:

npx intlayer init

سيؤدي هذا إلى إنشاء ملف intlayer.config.ts. في next.config.ts، استخدم wrapper المكوّن للحقن السلس لأسماء مستعارة next-intl نحو @intlayer/next-intl.

import type { NextConfig } from "next";
import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";

const withIntlayer = createNextIntlPlugin();

const nextConfig: NextConfig = {};

export default withIntlayer(nextConfig);

كيف يعمل تحت الغطاء

يستبدل wrapper bundler الترجمات، لكن يترك ميزات next-intl/navigation سليمة (مثل Link و redirect و usePathname).

تحت الغطاء:

• ICU runtime: تعمل علامات الجمع (=0 و one و other) و select/selectordinal و # والوسائط المنسقة ({ts, date, long}) بشكل صحيح باستخدام محلل resolveMessage(..., 'icu') المشترك.
• useTranslations() و getTranslations(): تستخرج استدعاءات النطاق الحافي أول جزء من المفتاح كمعرّف قاموس صحيح. يتم تقسيم الـ namespaces المتداخلة برشاقة إلى مسارات ومحدثات قاموس.
• Rich formatting: يتم تنفيذ t.rich() و t.markup() بالكامل بشكل أصلي، مما يحول الكود الشبيه بـ HTML إلى أجزاء React المعروضة.
• useFormatter: relativeTime و list و dateTimeRange والصيغ المسماة من إعدادات التكوين تنتقل إلى محولات Intl الأصلية الأساسية.