---
createdAt: 2025-02-07
updatedAt: 2025-06-29
title: توثيق Intlayer - الدليل الكامل للتدويل (i18n) لجافاسكريبت
description: توثيق كامل لـ Intlayer، مكتبة التدويل الحديثة لجافاسكريبت، React، Next.js، Express، والمزيد من الأُطُر.
keywords:
  - intlayer
  - التدويل
  - i18n
  - جافاسكريبت
  - React
  - Next.js
  - توثيق
  - ترجمة
  - متعدد اللغات
slugs:
  - doc
  - index
history:
  - version: 5.5.10
    date: 2025-06-29
    changes: بداية التاريخ
---

# توثيق Intlayer

مرحبًا بكم في التوثيق الرسمي لـ **Intlayer**! هنا، ستجد كل ما تحتاجه لدمج وتكوين وإتقان Intlayer لجميع احتياجات التدويل (i18n) الخاصة بك، سواء كنت تعمل مع **Next.js**، **React**، **Vite**، **Express**، أو أي بيئة جافاسكريبت أخرى.

يقدم Intlayer نهجًا مرنًا وحديثًا لترجمة تطبيقك. ستوجهك وثائقنا من التثبيت والإعداد إلى الميزات المتقدمة مثل **الترجمة المدعومة بالذكاء الاصطناعي**، وتعريفات **TypeScript**، ودعم **مكونات الخادم**، مما يمكنك من إنشاء تجربة متعددة اللغات بسلاسة.

---

## البدء

- **[مقدمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/introduction.md)**  
  احصل على نظرة عامة حول كيفية عمل Intlayer، وميزاته الأساسية، ولماذا يُعتبر تغييرًا جذريًا في مجال التدويل (i18n).

- **[كيفية عمل Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/how_works_intlayer.md)**  
  تعمق في التصميم المعماري وتعلم كيف يتعامل Intlayer مع كل شيء بدءًا من إعلان المحتوى وحتى تسليم الترجمة.

- **[التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)**  
  خصص Intlayer ليناسب احتياجات مشروعك. استكشف خيارات الوسيط، وهياكل الدليل، والإعدادات المتقدمة.

- **[واجهة سطر أوامر Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md)**

قم بإدارة المحتوى والترجمات باستخدام أداة سطر الأوامر الخاصة بنا. اكتشف كيفية دفع وسحب المحتوى، وأتمتة الترجمات، والمزيد.

- **[محرر Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)**  
  بسط التعاون مع غير المطورين وقم بتعزيز ترجماتك باستخدام الذكاء الاصطناعي، مباشرة في نظام إدارة المحتوى المجاني والبديهي الخاص بنا.

---

## المفاهيم الأساسية

### القاموس

نظم محتواك متعدد اللغات بالقرب من كودك للحفاظ على كل شيء متسقًا وقابلًا للصيانة.

- **[البدء](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md)**  
  تعلّم أساسيات إعلان محتواك في Intlayer.

- **[الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)**  
  فهم كيفية إنشاء الترجمات وتخزينها واستخدامها في تطبيقك.

- **[التعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/enumeration.md)**  
  إدارة مجموعات البيانات المتكررة أو الثابتة بسهولة عبر لغات متعددة.

- **[الشرط](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/condition.md)**  
  تعلّم كيفية استخدام المنطق الشرطي في Intlayer لإنشاء محتوى ديناميكي.

- **[الإدخال](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/insertion.md)**  
  اكتشف كيفية إدخال القيم في سلسلة نصية باستخدام نُسخ الإدخال.

- **[جلب الدوال](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/function_fetching.md)**  
  شاهد كيفية جلب المحتوى ديناميكيًا باستخدام منطق مخصص ليتناسب مع سير عمل مشروعك.

- **[ماركداون](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)**  
  تعلّم كيفية استخدام ماركداون في Intlayer لإنشاء محتوى غني.

- **[تضمين الملفات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/file.md)**  
  اكتشف كيفية تضمين ملفات خارجية في Intlayer لاستخدامها في محرر المحتوى.

- **[التداخل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/nesting.md)**  
  افهم كيفية تداخل المحتوى في Intlayer لإنشاء هياكل معقدة.

---

## البيئات والتكاملات

لقد قمنا ببناء Intlayer مع وضع المرونة في الاعتبار، مقدمين تكاملًا سلسًا عبر الأُطُر وأدوات البناء الشائعة:

- **[Intlayer مع Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)**
- **[Intlayer مع Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_14.md)**
- **[Intlayer مع Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_page_router.md)**
- **[Intlayer مع React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_create_react_app.md)**
- **[Intlayer مع Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md)**
- **[Intlayer مع React Native و Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react_native+expo.md)**
- **[Intlayer مع Lynx و React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_lynx+react.md)**
- **[Intlayer مع Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_express.md)**

تتضمن كل دليل تكامل أفضل الممارسات لاستخدام ميزات Intlayer، مثل **التصيير على جانب الخادم**، **التوجيه الديناميكي**، أو **التصيير على جانب العميل**، حتى تتمكن من الحفاظ على تطبيق سريع، صديق لمحركات البحث، وقابل للتوسع بشكل كبير.

---

## الحزم

يقدم التصميم المعياري لـ Intlayer حزم مخصصة لبيئات واحتياجات محددة:

### `intlayer`

وظائف الأدوات الأساسية لتكوين وإدارة إعدادات التدويل (i18n) الخاصة بك.

- **[getConfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getConfiguration.md)**
- **[getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getHTMLTextDir.md)**
- **[getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocaleLang.md)**
- **[getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocaleName.md)**
- **[getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md)**
- **[getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getMultilingualUrls.md)**
- **[getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md)**
- **[getTranslation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getTranslation.md)**
- **[getEnumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getEnumeration.md)**

### `express-intlayer`

استخدم Intlayer داخل تطبيقات **Express**:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/express-intlayer/t.md)**  
  مساعد ترجمة بسيط ومباشر لمسارات الخادم والعروض الخاصة بك.

### `react-intlayer`

عزز تطبيقات **React** الخاصة بك باستخدام الخطافات القوية:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/t.md)**
- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useIntlayer.md)**
- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useDictionary.md)**
- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useLocale.md)**

### `next-intlayer`

اندماج سلس مع **Next.js**:

- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/t.md)**
- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useIntlayer.md)**
- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useDictionary.md)**
- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useLocale.md)**

---

## موارد إضافية

- **[مدونة: Intlayer و i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_i18next.md)**  
  تعرّف على كيفية تكامل Intlayer ومقارنته مع مكتبة **i18next** الشهيرة.

- **[دروس مباشرة على يوتيوب](https://youtu.be/W2G7KxuSD4c?si=GyU_KpVhr61razRw)**  
  شاهد عرضًا توضيحيًا شاملاً وتعلم كيفية دمج Intlayer في الوقت الحقيقي.

---

## المساهمة والتعليقات

نحن نقدر قوة المصادر المفتوحة والتطوير المدفوع من قبل المجتمع. إذا كنت ترغب في اقتراح تحسينات، أو إضافة دليل جديد، أو تصحيح أي مشاكل في مستنداتنا، فلا تتردد في تقديم طلب سحب (Pull Request) أو فتح مشكلة على [مستودع GitHub الخاص بنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs).

**هل أنت مستعد لترجمة تطبيقك بشكل أسرع وأكثر كفاءة؟** اغمر نفسك في مستنداتنا لبدء استخدام Intlayer اليوم. اختبر نهجًا قويًا ومنظمًا للتدويل يحافظ على تنظيم محتواك ويجعل فريقك أكثر إنتاجية.
