لماذا يجب أن تفكر في Intlayer؟

ما هو Intlayer؟

Intlayer هو مكتبة تعريب (تدويل) مصممة خصيصًا لمطوري جافا سكريبت. يسمح لك بالإعلان عن محتواك في كل مكان داخل الكود الخاص بك. يقوم بتحويل إعلانات المحتوى متعدد اللغات إلى قواميس منظمة لتتكامل بسهولة في كودك. باستخدام TypeScript، يجعل Intlayer تطويرك أقوى وأكثر كفاءة.

لماذا تم إنشاء Intlayer؟

تم إنشاء Intlayer لحل مشكلة شائعة تؤثر على جميع مكتبات i18n الشائعة مثل next-intl، react-i18next، react-intl، next-i18next، react-intl، و vue-i18n.

تعتمد كل هذه الحلول على نهج مركزي لقائمة وإدارة المحتوى الخاص بك. على سبيل المثال:

.├── locales│   ├── en.json│   ├── fr.json│   └── es.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

أو هنا باستخدام المساحات الاسمية:

.├── locales│   ├── en│   │  ├── footer.json│   │  └── navbar.json│   ├── fr│   │  ├── footer.json│   │  └── navbar.json│   └── es│      ├── footer.json│      └── navbar.json├── i18n.ts└── src    └── components        └── MyComponent            └── index.tsx

هذا النوع من البنية يبطئ عملية التطوير ويجعل قاعدة الشيفرة أكثر تعقيدًا للصيانة لأسباب عدة:

1. لأي مكون جديد يتم إنشاؤه، يجب عليك:

   • إنشاء المورد/المساحة الاسمية الجديدة في مجلد locales
   • تذكر استيراد المساحة الاسمية الجديدة في صفحتك
   • ترجمة المحتوى الخاص بك (غالبًا ما يتم ذلك يدويًا عن طريق النسخ/اللصق من مزودي الذكاء الاصطناعي)

2. لأي تغيير يتم على مكوناتك، يجب عليك:

   • البحث عن المورد/المساحة الاسمية ذات الصلة (بعيدًا عن المكون)
   • ترجمة المحتوى الخاص بك
   • التأكد من تحديث المحتوى الخاص بك لكل لغة
   • التحقق من أن المساحة الاسمية لا تحتوي على مفاتيح/قيم غير مستخدمة
   • التأكد من أن هيكل ملفات JSON هو نفسه لجميع اللغات

في المشاريع الاحترافية التي تستخدم هذه الحلول، غالبًا ما تُستخدم منصات الترجمة للمساعدة في إدارة ترجمة المحتوى الخاص بك. ومع ذلك، يمكن أن يصبح هذا مكلفًا بسرعة للمشاريع الكبيرة.

لحل هذه المشكلة، تعتمد Intlayer نهجًا يقوم بتحديد نطاق المحتوى الخاص بك لكل مكون ويحافظ على المحتوى قريبًا من المكون الخاص بك، كما نفعل غالبًا مع CSS (styled-components)، وأنواع البيانات، والوثائق (storybook)، أو اختبارات الوحدة (jest).

.└── components    └── MyComponent        ├── index.content.ts        ├── index.test.tsx        ├── index.stories.tsx        └── index.tsx

import { t, type Dictionary } from "intlayer";const componentExampleContent = {  key: "component-example",  content: {    myTranslatedContent: t({      en: "Hello World",      es: "Hola Mundo",      fr: "Bonjour le monde",    }),  },} satisfies Dictionary;export default componentExampleContent;

import { useIntlayer } from "react-intlayer";export const ComponentExample = () => {  const { myTranslatedContent } = useIntlayer("component-example");  return <span>{myTranslatedContent}</span>;};

تتيح لك هذه الطريقة:

1. زيادة سرعة التطوير

   • يمكن إنشاء ملفات .content.{{ts|mjs|cjs|json}} باستخدام إضافة VSCode
   • يمكن لأدوات الإكمال التلقائي المعتمدة على الذكاء الاصطناعي في بيئة التطوير الخاصة بك (مثل GitHub Copilot) مساعدتك في إعلان المحتوى الخاص بك، مما يقلل من النسخ/اللصق

2. تنظيف قاعدة الشيفرة الخاصة بك

   • تقليل التعقيد
   • زيادة قابلية الصيانة

3. تكرار مكوناتك والمحتوى المرتبط بها بسهولة أكبر (مثال: مكونات تسجيل الدخول/التسجيل، إلخ)

   • من خلال الحد من خطر التأثير على محتوى المكونات الأخرى
   • من خلال نسخ/لصق المحتوى الخاص بك من تطبيق إلى آخر بدون تبعيات خارجية

4. تجنب تلويث قاعدة الشيفرة الخاصة بك بمفاتيح/قيم غير مستخدمة للمكونات غير المستخدمة

   • إذا لم تستخدم مكونًا، فلن يقوم Intlayer باستيراد المحتوى المرتبط به
   • إذا قمت بحذف مكون، ستتذكر بسهولة أكبر إزالة المحتوى المرتبط به لأنه سيكون موجودًا في نفس المجلد

5. تقليل تكلفة التفكير لوكلاء الذكاء الاصطناعي لإعلان المحتوى متعدد اللغات الخاص بك

   • لن يضطر وكيل الذكاء الاصطناعي إلى مسح قاعدة الشيفرة الخاصة بك بالكامل لمعرفة مكان تنفيذ المحتوى الخاص بك
   • يمكن إجراء الترجمات بسهولة بواسطة أدوات الإكمال التلقائي للذكاء الاصطناعي في بيئة التطوير الخاصة بك (مثل GitHub Copilot)

الميزات الإضافية لـ Intlayer

الميزة	الوصف
	دعم عبر الأُطُر المختلفة يتوافق Intlayer مع جميع الأُطُر والمكتبات الرئيسية، بما في ذلك Next.js و React و Vite و Vue.js و Nuxt و Preact و Express والمزيد.
	إدارة المحتوى باستخدام جافاسكريبت استفد من مرونة جافاسكريبت لتعريف وإدارة محتواك بكفاءة. - إعلان المحتوى
	ملف إعلان المحتوى لكل لغة سرّع عملية تطويرك من خلال إعلان محتواك مرة واحدة، قبل التوليد التلقائي. - ملف إعلان المحتوى لكل لغة
	بيئة آمنة من حيث النوع استفد من TypeScript لضمان أن تعريفات المحتوى والرمز الخاص بك خالية من الأخطاء، مع الاستفادة أيضًا من الإكمال التلقائي في بيئة التطوير المتكاملة (IDE). - تكوين TypeScript
	إعداد مبسط ابدأ بسرعة مع أقل قدر من التهيئة. قم بضبط الإعدادات الخاصة بالتدويل، التوجيه، الذكاء الاصطناعي، البناء، وإدارة المحتوى بسهولة. - استكشاف تكامل Next.js
	استرجاع المحتوى المبسط لا حاجة لاستدعاء دالة t لكل قطعة محتوى. استرجع كل محتواك مباشرة باستخدام هوك واحد. - تكامل React
	تنفيذ متسق لمكونات الخادم مناسب تمامًا لمكونات الخادم في Next.js، استخدم نفس التنفيذ لكل من مكونات العميل والخادم، لا حاجة لتمرير دالة t الخاصة بك عبر كل مكون خادم. - مكونات الخادم
	قاعدة شفرة منظمة حافظ على تنظيم قاعدة الشفرة الخاصة بك بشكل أفضل: مكون واحد = قاموس واحد في نفس المجلد. الترجمة القريبة من مكوناتها تعزز من سهولة الصيانة والوضوح. - كيف يعمل Intlayer
	توجيه محسّن دعم كامل لتوجيه التطبيقات، يتكيف بسلاسة مع هياكل التطبيقات المعقدة، لـ Next.js و React و Vite و Vue.js، وغيرها. - استكشاف تكامل Next.js
	دعم ماركداون استيراد وتفسير ملفات اللغة وملفات ماركداون عن بُعد للمحتوى متعدد اللغات مثل سياسات الخصوصية، الوثائق، إلخ. تفسير وجعل بيانات التعريف الخاصة بماركداون متاحة في كودك. - ملفات المحتوى
	محرر مرئي مجاني ونظام إدارة محتوى يتوفر محرر مرئي مجاني ونظام إدارة محتوى لكتاب المحتوى، مما يلغي الحاجة إلى منصة تعريب. حافظ على تزامن محتواك باستخدام Git، أو قم بتفويضه كليًا أو جزئيًا باستخدام نظام إدارة المحتوى. - محرر Intlayer - نظام إدارة محتوى Intlayer
	محتوى قابل للتقليل الشجري محتوى قابل للتقليل الشجري، مما يقلل من حجم الحزمة النهائية. يقوم بتحميل المحتوى لكل مكون، مستبعدًا أي محتوى غير مستخدم من الحزمة الخاصة بك. يدعم التحميل الكسول لتحسين كفاءة تحميل التطبيق. - تحسين بناء التطبيق
	العرض الثابت لا يعوق العرض الثابت. - تكامل Next.js
	الترجمة المدعومة بالذكاء الاصطناعي حوّل موقعك الإلكتروني إلى 231 لغة بنقرة واحدة فقط باستخدام أدوات الترجمة المتقدمة المدعومة بالذكاء الاصطناعي من Intlayer باستخدام مزود الذكاء الاصطناعي الخاص بك/مفتاح API الخاص بك. - تكامل CI/CD - واجهة سطر أوامر Intlayer - الملء التلقائي
	تكامل خادم MCP يوفر خادم MCP (بروتوكول سياق النموذج) لأتمتة بيئة التطوير المتكاملة (IDE)، مما يتيح إدارة محتوى سلسة وسير عمل التدويل (i18n) مباشرة داخل بيئة التطوير الخاصة بك. - خادم MCP
	امتداد VSCode يوفر Intlayer امتدادًا لـ VSCode لمساعدتك في إدارة المحتوى والترجمات الخاصة بك، وبناء قواميسك، وترجمة المحتوى الخاص بك، والمزيد. - امتداد VSCode
	التشغيل البيني يتيح التشغيل البيني مع react-i18next و next-i18next و next-intl و react-intl. - Intlayer و react-intl - Intlayer و next-intl - Intlayer و next-i18next

مقارنة Intlayer مع الحلول الأخرى

تاريخ الوثيقة