كيفية تنفيذ التدويل في تطبيق Next.js يستخدم Pages Router
اجعل تطبيق React الخاص بك أكثر سهولة في الوصول إليه واستهدف أسواقًا جديدة من خلال التدويل (i18n).
مع تزايد العولمة، يصبح من المهم بشكل متزايد لمطوري الويب بناء تطبيقات قادرة على تلبية احتياجات المستخدمين من دول وثقافات مختلفة. إحدى الطرق الأساسية لتحقيق ذلك هي التدويل (i18n)، مما يتيح لك تكييف تطبيقك ليتوافق مع لغات مختلفة، والعملات، وتنسيقات التاريخ.
في هذا الدليل، سنستعرض كيفية إضافة التدويل إلى تطبيق React Next.js الخاص بك، مع العرض من جانب الخادم. TL;DR: شاهد المثال الكامل هنا.
هذا الدليل مخصص لتطبيقات Next.js التي تستخدم Pages Router.
إذا كنت تستخدم App Router، يُرجى الاطلاع على هذا الدليل بدلاً من ذلك.
الخطوة 1: ثبّت مكتبة i18n
لتنفيذ التدويل في تطبيق Next.js الخاص بك، سنختار أولًا مكتبة i18n. هناك العديد من المكتبات الشائعة، بما في ذلك next-intl. ومع ذلك، سنستخدم في هذا المثال TacoTranslate.
تترجم TacoTranslate سلاسل النصوص الخاصة بك تلقائيًا إلى أي لغة باستخدام أحدث تقنيات الذكاء الاصطناعي، وتوفر عليك عناء إدارة ملفات JSON يدويًا.
لنثبّتها باستخدام npm في الطرفية لديك:
npm install tacotranslateالخطوة 2: أنشئ حسابًا مجانيًا على TacoTranslate
بعد تثبيت الوحدة، حان الوقت لإنشاء حسابك على TacoTranslate ومشروع ترجمة ومفاتيح API المرتبطة به. أنشئ حسابًا هنا. الخدمة مجانية، ولا تتطلب إضافة بطاقة ائتمانية.
داخل واجهة تطبيق TacoTranslate، أنشئ مشروعًا وانتقل إلى علامة تبويب مفاتيح API الخاصة به. أنشئ مفتاحًا واحدًا من نوع read، ومفتاحًا واحدًا من نوع read/write. سنحفظهما كمتغيرات بيئية. نُطلق على مفتاح read اسم public، وعلى مفتاح read/write اسم secret. على سبيل المثال، يمكنك إضافتهما إلى ملف .env في المجلد الجذر لمشروعك.
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010احرص على عدم تسريب مفتاح واجهة برمجة التطبيقات السري read/write مطلقًا إلى بيئات الإنتاج من جهة العميل.
سنضيف أيضًا متغيرين آخرين للبيئة: TACOTRANSLATE_DEFAULT_LOCALE وTACOTRANSLATE_ORIGIN.
TACOTRANSLATE_DEFAULT_LOCALE: رمز اللغة الافتراضي الاحتياطي. في هذا المثال، سنعيّنه إلىenللغة الإنجليزية.TACOTRANSLATE_ORIGIN: «المجلد» الذي سيتم تخزين السلاسل النصية فيه، مثل عنوان URL لموقعك الإلكتروني. اقرأ المزيد عن الأصول هنا.
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.comالخطوة 3: إعداد TacoTranslate
لدمج TacoTranslate مع تطبيقك، ستحتاج إلى إنشاء عميل باستخدام مفاتيح API التي أنشأتها سابقًا. على سبيل المثال، أنشئ ملفًا باسم /tacotranslate-client.js.
const {default: createTacoTranslateClient} = require('tacotranslate');
const tacoTranslate = createTacoTranslateClient({
apiKey:
process.env.TACOTRANSLATE_SECRET_API_KEY ??
process.env.TACOTRANSLATE_PUBLIC_API_KEY ??
process.env.TACOTRANSLATE_API_KEY ??
'',
projectLocale: process.env.TACOTRANSLATE_DEFAULT_LOCALE ?? '',
});
module.exports = tacoTranslate;سنقوم بتعريف TACOTRANSLATE_API_KEY تلقائيًا بعد قليل.
يُسهّل إنشاء العميل في ملف منفصل إعادة استخدامه لاحقًا. والآن، باستخدام ملف /pages/_app.tsx مخصّص، سنضيف موفّر TacoTranslate.
import React from 'react';
import {type AppProps} from 'next/app';
import {type Origin, type Locale, type Localizations} from 'tacotranslate';
import TacoTranslate from 'tacotranslate/react';
import TacoTranslateHead from 'tacotranslate/next/head';
import tacoTranslate from '../tacotranslate-client';
type PageProperties = {
origin: Origin;
locale: Locale;
locales: Locale[];
localizations: Localizations;
};
export default function App({Component, pageProps}: AppProps<PageProperties>) {
const {origin, locale, locales, localizations} = pageProps;
return (
<TacoTranslate
client={tacoTranslate}
origin={origin}
locale={locale}
localizations={localizations}
>
<TacoTranslateHead rootUrl="https://your-website.com" locales={locales} />
<Component {...pageProps} />
</TacoTranslate>
);
}إذا كان لديك بالفعل pageProps و_app.tsx مخصّصان، فالرجاء توسيع التعريف ليشمل الخصائص والتعليمات البرمجية المذكورة أعلاه.
الخطوة 4: تنفيذ العرض من جانب الخادم
يتيح TacoTranslate عرض ترجماتك من جانب الخادم. وهذا يحسّن تجربة المستخدم بشكل كبير من خلال عرض المحتوى المترجم فورًا، بدلًا من ظهور المحتوى غير المترجم للحظات أولًا. بالإضافة إلى ذلك، يمكننا تخطي طلبات الشبكة على جانب العميل، لأن جميع الترجمات التي نحتاج إليها متوفرة لدينا بالفعل.
سنبدأ بإنشاء /next.config.js أو تعديله.
const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');
module.exports = async () => {
const config = {};
return withTacoTranslate(config, {
client: tacoTranslateClient,
isProduction:
process.env.TACOTRANSLATE_ENV === 'production' ||
process.env.VERCEL_ENV === 'production' ||
(!(process.env.TACOTRANSLATE_ENV || process.env.VERCEL_ENV) &&
process.env.NODE_ENV === 'production'),
});
};قم بتعديل فحص isProduction ليتناسب مع إعداداتك. إذا كان true, فسيعرض TacoTranslate مفتاح واجهة برمجة التطبيقات العام. إذا كنا في بيئة محلية أو اختبارية أو بيئة تجهيزية (isProduction is false)، سنستخدم مفتاح واجهة برمجة التطبيقات السري read/write لضمان إرسال السلاسل الجديدة للترجمة.
حتى الآن، قمنا فقط بإعداد تطبيق Next.js بقائمة من اللغات المدعومة. الأمر التالي الذي سنفعله هو جلب الترجمات لجميع صفحاتك. للقيام بذلك، ستستخدم إما getTacoTranslateStaticProps أو getTacoTranslateServerSideProps بناءً على متطلباتك.
تأخذ هذه الدوال ثلاثة معطيات: كائن واحد من نوع Next.js Static Props Context, وإعدادات لـ TacoTranslate، وخصائص اختيارية من Next.js. لاحظ أن revalidate في getTacoTranslateStaticProps مضبوط على 60 افتراضياً، بحيث تبقى ترجماتك محدثة.
لاستخدام أيٍّ من الدالتين في صفحة، لنفترض أن لديك ملف صفحة مثل /pages/hello-world.tsx.
import {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
export async function getStaticProps(context) {
return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}
export default function Page() {
return <Translate string="Hello, world!"/>;
}يمكنك الآن استخدام مكوّن Translate لترجمة السلاسل النصية ضمن جميع مكوّنات React لديك.
import {Translate} from 'tacotranslate/react';
function Component() {
return <Translate string="Hello, world!"/>
}الخطوة 5: انشر واختبر!
لقد انتهينا! ستتم ترجمة تطبيق React الخاص بك تلقائيًا عند إضافة أي سلاسل نصية إلى مكوّن Translate. لاحظ أن البيئات التي تتمتع فقط بصلاحيات read/write لمفتاح API ستتمكن من إنشاء سلاسل نصية جديدة لترجمتها. نوصي بوجود بيئة تجريبية مغلقة وآمنة يمكنك فيها اختبار تطبيقك الإنتاجي باستخدام مفتاح API من هذا النوع، وإضافة سلاسل نصية جديدة قبل إطلاق التطبيق. سيمنع ذلك أي شخص من سرقة مفتاح API السري الخاص بك، ومن تضخيم مشروع الترجمة الخاص بك بإضافة سلاسل نصية جديدة وغير مرتبطة.
تأكد من الاطلاع على المثال الكامل على ملفنا في GitHub. هناك، ستجد أيضًا مثالًا يوضح كيفية القيام بذلك باستخدام App Router! إذا واجهت أي مشاكل، فلا تتردد في التواصل معنا، وسوف نكون أكثر من سعداء لمساعدتك.
TacoTranslate تتيح لك تعريب تطبيقات React الخاصة بك تلقائيًا بسرعة إلى ومن أكثر من 75 لغة. ابدأ اليوم!