@intlayer/docs 6.0.0 → 6.0.2-canary.0

package/docs/ar/releases/v6.md

@@ -0,0 +1,273 @@
+---
+createdAt: 2025-09-22
+updatedAt: 2025-09-22
+title: الإصدار الجديد Intlayer v6 - ما الجديد؟
+description: اكتشف ما الجديد في Intlayer v6. تحسينات كبيرة في الأداء، تجربة المطور، وميزات جديدة لتعزيز سير عمل التدويل الخاص بك.
+keywords:
+  - Intlayer
+  - التوطين
+  - التطوير
+  - الأداء
+  - تجربة المطور
+  - الميزات
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - releases
+  - v6
+---
+
+# الإصدار الجديد Intlayer v6 - ما الجديد؟
+
+مرحبًا بك في Intlayer v6! يركز هذا الإصدار على الأداء، تجربة المطور، والموثوقية. فيما يلي أبرز النقاط، مع ملاحظات الترحيل وأمثلة قابلة للنسخ واللصق.
+
+## أبرز النقاط
+
+- أمر جديد: `npx intlayer content test` لاكتشاف الترجمات المفقودة
+- خيار عالمي جديد `autoFill` لتوليد الترجمات المفقودة تلقائيًا
+- أمر التعبئة (Fill) يتخطى الترجمات الموجودة بشكل افتراضي: `npx intlayer fill`
+- امتداد VS Code: شريط نشاط Intlayer جديد (بحث وقواميس)، أزرار شريط الأدوات/السياق، الكشف التلقائي، أوامر التعبئة/الاختبار
+- بناء أسرع 10 مرات بفضل التوازي في الوعود (promise parallelization)
+- تخزين مؤقت للقاموس عن بُعد لتجنب إعادة التحميل عند بدء التطبيق
+- تحسين التسجيل: اضبط `log.mode: 'verbose'` لفحص السلوك
+- تحقق أقوى لمنع تعطل التطبيق بسبب مشاكل في القاموس
+- تحديثات حية مع نظام إدارة المحتوى (CMS) باستخدام `build.importMode = 'live'` و `pnpm intlayer live`
+- إصلاحات: تكامل Vue.js، محول Lynx، المحرر المرئي على ويندوز
+
+---
+
+## جديد: اختبار الترجمات المفقودة
+
+قم بتدقيق مشروعك بسرعة لمعرفة المفاتيح/اللغات المفقودة.
+
+```bash
+npx intlayer content test
+```
+
+الإخراج:
+
+```bash
+pnpm intlayer content test
+الترجمات المفقودة:
+ - blog-data       - اليابانية (ja)، الكورية (ko)، الصينية (zh)، الألمانية (de)، الإيطالية (it) - src/components/BlogPage/blogData.content.ts
+ - demo-page       - الفرنسية (fr)، الإيطالية (it)                                         - src/components/DemoPage/demo.content.ts
+ - locale-switcher - الإيطالية (it)، البرتغالية (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.ts
+اللغات: الإنجليزية (en)، الروسية (ru)، اليابانية (ja)، الفرنسية (fr)، الكورية (ko)، الصينية (zh)، الإسبانية (es)، الألمانية (de)، العربية (ar)، الإيطالية (it)، الإنجليزية البريطانية (en-GB)، البرتغالية (pt)، الهندية (hi)
+اللغات المطلوبة: الإنجليزية (en)
+اللغات المفقودة: اليابانية (ja)، الكورية (ko)، الصينية (zh)، الألمانية (de)، الإيطالية (it)، الفرنسية (fr)، البرتغالية (pt)
+اللغات المطلوبة المفقودة: -
+إجمالي اللغات المفقودة: 7
+إجمالي اللغات المطلوبة المفقودة: 0
+```
+
+راجع المزيد من الخيارات في وثائق CLI: [مرجع CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md) → "اختبار الترجمات المفقودة". وكذلك دليل [الاختبار](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/testing.md).
+
+---
+
+## جديد: التعبئة التلقائية العالمية لإكمال الترجمات المفقودة
+
+يمكنك الآن تمكين التعبئة التلقائية على مستوى العالم بحيث يتم إكمال أي قاموس يحتوي على ترجمات مفقودة تلقائيًا.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  content: {
+    // توليد تلقائي للترجمات المفقودة لجميع القواميس
+    autoFill: "./{{fileName}}.content.ts",
+    //
+    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // autoFill: true, // توليد تلقائي للترجمات المفقودة لجميع القواميس مثل استخدام "./{{fileName}}.content.json"
+    //
+    // autoFill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+يمكنك أيضًا ضبط كل قاموس بدقة باستخدام حقل `autoFill` في ملفات المحتوى. راجع المرجع الكامل في `doc/autoFill` و `doc/dictionary/content_file`.
+
+---
+
+## أمر fill: إعدادات افتراضية أكثر أمانًا
+
+أمر fill الآن، بشكل افتراضي، يملأ الترجمات المفقودة فقط ويتخطى المحتوى الموجود.
+
+```bash
+npx intlayer fill
+```
+
+```bash
+المفاتيح المتأثرة في القواميس للمعالجة: access-key-creation-form-schema, doc-search-metadata, doc-search-page
+  - [access-key-creation-form-schema]      القاموس لا يحتوي على مسار ملف. يتم التخطي.
+  - [access-key-creation-form-schema]      معالجة إعلان المحتوى: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
+  - [access-key-creation-form-schema]      لا توجد لغات لملئها - يتم تخطي القاموس
+  - [doc-search-metadata]                  القاموس لا يحتوي على مسار ملف. يتم التخطي.
+  - [doc-search-metadata]                  معالجة إعلان المحتوى: src/app/[locale]/(docs)/doc/search/metadata.content.ts
+  - [doc-search-metadata]                  لا توجد لغات لملئها - يتم تخطي القاموس
+  - [doc-search-page]                      القاموس لا يحتوي على مسار ملف. يتم التخطي.
+  - [doc-search-page]                      معالجة إعلان المحتوى: src/app/[locale]/(docs)/doc/search/page.content.ts
+  - [doc-search-page]                     [الروسية (ru)]                   تجهيز الترجمة للقاموس من الإنجليزية (en) إلى الروسية (ru)
+[intlayer]  تم تطبيق تنسيق Prettier على src/app/[locale]/(docs)/doc/search/page.content.ts
+  - [doc-search-page]                      تم كتابة إعلان المحتوى إلى src/app/[locale]/(docs)/doc/search/page.content.ts
+```
+
+أمثلة CI متاحة في [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/CI_CD.md).
+
+---
+
+## تحديث امتداد VS Code
+
+يتضمن الامتداد الآن تبويب مخصص لـ Intlayer في شريط النشاط وعدة تحسينات في سير العمل:
+
+- شريط نشاط Intlayer مع عرضين:
+  - عرض ويب البحث (`intlayer.searchBar`) للبحث المباشر في القاموس/المحتوى
+  - شجرة القواميس (`intlayer.dictionaries`) التي تعرض البيئات، القواميس، والملفات المساهمة
+- شريط أدوات في عرض القواميس: بناء، سحب، دفع، ملء، تحديث، اختبار، إنشاء ملف قاموس
+- قوائم السياق: سحب/دفع على القواميس؛ ملء على الملفات
+- الكشف التلقائي: يتم تمييز ملف المحرر الحالي في شجرة القواميس عند الاقتضاء
+- أوامر جديدة متاحة من لوحة الأوامر: ملء القواميس واختبار القواميس
+
+راجع التفاصيل في توثيق [امتداد VS Code الرسمي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md).
+
+---
+
+## الأداء: أسرع 10 مرات
+
+- حل متوازي للقواميس المحلية والبعيدة
+- يتم تخزين القواميس البعيدة مؤقتًا لتجنب إعادة الجلب عند بدء تشغيل التطبيق
+
+```bash
+npx intlayer build
+```
+
+المخرجات:
+
+```bash
+[intlayer]  Preparing Intlayer (v6.0.1)
+[intlayer]  Dictionaries:
+[intlayer]  ✓ Local content: 163/163
+[intlayer]  ✓ Remote content: 100/100
+[intlayer]   - access-key-creation-form             [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - access-key-creation-form-schema      [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - access-key-form                      [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - ai-ab-testing-section                                 [distant: ✔ imported]
+[intlayer]   - application-not-running-view         [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - application-template-message         [local: ✔ built] [distant: ✔ fetched]
+[intlayer]   - aside-navigation                     [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - ask-reset-password                   [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - ask-reset-password-schema            [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - autocompletion-section               [local: ✔ built] [distant: ✔ fetched]
+[intlayer]   - available-techno-section             [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - blog-data                            [local: ✔ built]
+[intlayer]   - blog-metadata                        [local: ✔ built]
+[intlayer]   - blog-nav-list                        [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - blog-page                                             [distant: ✔ fetched]
+[intlayer]   - blog-search-metadata                 [local: ✔ built] [distant: ✔ imported]
+[intlayer]   - blog-search-page                     [local: ✔ built] [distant: ✔ imported]
+...
+[intlayer]  تم تحميل المحتوى  (الإجمالي: 8401 مللي ثانية - محلي: 4050 مللي ثانية - عن بُعد: 4222 مللي ثانية)
+```
+
+---
+
+## تحسينات التسجيل
+
+تم تحسين نظام التسجيل لتوفير معلومات أكثر تفصيلاً حول ما يحدث أثناء عمليات التحويل في وقت البناء والتشغيل.
+
+> قم بتمكين السجلات المفصلة لفهم أفضل لما يحدث أثناء عمليات التحويل في وقت البناء والتشغيل.
+
+```ts fileName="intlayer.config.ts"
+export default {
+  log: {
+    mode: "verbose", // الخيارات: "default" | "verbose" | "disabled"
+  },
+};
+```
+
+راجع [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md) لجميع خيارات التسجيل.
+
+---
+
+## تحقق أقوى
+
+يقوم الآن معالجة القاموس بإجراء تحقق أكثر صلابة. عندما يفشل القاموس في المعالجة، يتجنب Intlayer كسر تطبيقك ويعرض أخطاء قابلة للتنفيذ.
+
+---
+
+## التحديثات الحية مع نظام إدارة المحتوى (آمن للإنتاج)
+
+قم بتقديم تحديثات المحتوى الحية (مثل التحديثات التحريرية) في بيئة الإنتاج دون الحاجة إلى إعادة بناء تطبيقك.
+
+1. قم بتمكين وضع الاستيراد الحي:
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  build: {
+    importMode: "live", // "static" | "dynamic" | "live"
+  },
+  editor: {
+    liveSync: true, // تمكين المزامنة الحية على جانب الخادم
+  },
+};
+
+export default config;
+```
+
+2. قم بتشغيل تطبيقك والمعالجة الحية جنبًا إلى جنب:
+
+```bash
+npx intlayer live --process 'vite preview'
+```
+
+ملاحظات:
+
+- سيتم جلب القواميس التي تم تمييزها لاستخدام الوضع الحي فقط بشكل مباشر. أما القواميس الأخرى فهي محسّنة للأداء.
+- يتم الرجوع إلى الاستيراد الديناميكي إذا لم يكن من الممكن الوصول إلى واجهة برمجة التطبيقات الحية.
+
+راجع [نظام إدارة المحتوى والمزامنة الحية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) و [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md) للحصول على إرشادات كاملة.
+
+---
+
+## ملاحظات الترحيل
+
+- تمت الإزالة: `dictionaryOutput` (كان يُستخدم سابقًا مع `i18next` أو `next-intl`). سيعود هذا كموصلات قابلة للإضافة في الإصدارات المستقبلية. قم بإزالة هذا الحقل من تكوينك.
+- إزالة ذات صلة: `i18nextResourcesDir` (راجع سجل التغييرات في `doc/configuration`).
+- يُفضل استخدام الخيار العالمي الجديد `content.autoFill` لتوليد الترجمات المفقودة على نطاق واسع.
+- استخدم الأمر `npx intlayer content test` للتحقق من طلبات السحب (PRs) المتعلقة بالترجمات المفقودة.
+- للحصول على تشخيص مفصل، قم بتعيين `log.mode = 'verbose'`.
+
+---
+
+## الإصلاحات
+
+- استقرار تكامل Vue.js
+- تحسينات موصل Lynx
+- المحرر المرئي على نظام ويندوز
+
+---
+
+## روابط مفيدة
+
+- [مرجع CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md)
+- [الملء التلقائي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/autoFill.md)
+- [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)
+- [مرجع ملف المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md)
+- [امتداد VS Code الرسمي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)
+- [نظام إدارة المحتوى والمزامنة الحية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)

package/docs/ar/roadmap.md

@@ -111,18 +111,16 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 يدعم Intlayer صيغة **TypeScript** (وكذلك JavaScript) و **JSON** لإعلان المحتوى.
 
 - **TypeScript**:
-
   - يضمن أن هيكل المحتوى الخاص بك صحيح وأنه لا توجد ترجمات مفقودة.
   - يقدم أوضاع تحقق صارمة أو أكثر مرونة.
   - يسمح بجلب البيانات ديناميكيًا من المتغيرات أو الدوال أو واجهات برمجة التطبيقات الخارجية.
 
 - **JSON**:
-
   - يجعل من السهل التكامل مع الأدوات الخارجية (مثل المحررين المرئيين) بسبب تنسيقه الموحد.
 
   > الموارد:
   >
-  > - [تنسيقات إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_extention_customization.md)
+  > - [تنسيقات إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md)
 
 ### 7. التنقية، تحسين الحزمة والاستيراد الديناميكي
 

package/docs/ar/vs_code_extension.md

@@ -1,10 +1,10 @@
 ---
 createdAt: 2025-03-17
-updatedAt: 2025-06-29
-title: إضافة VS Code الرسمية
-description: تعلّم كيفية استخدام إضافة Intlayer في VS Code لتعزيز سير عمل التطوير الخاص بك. تنقل بسرعة بين المحتوى المحلي وأدر قواميسك بكفاءة.
+updatedAt: 2025-09-22
+title: ملحق VS Code الرسمي
+description: تعلّم كيفية استخدام ملحق Intlayer في VS Code لتعزيز سير عمل التطوير الخاص بك. تنقل بسرعة بين المحتوى المحلي وأدر القواميس الخاصة بك بكفاءة.
 keywords:
-  - إضافة VS Code
+  - ملحق VS Code
   - Intlayer
   - التوطين
   - أدوات التطوير
@@ -17,41 +17,89 @@ slugs:
   - vs-code-extension
 ---
 
-# إضافة VS Code الرسمية
+# ملحق VS Code الرسمي
 
 ## نظرة عامة
 
-[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) هي الإضافة الرسمية لـ Visual Studio Code لـ **Intlayer**، مصممة لتحسين تجربة المطور عند العمل مع المحتوى المحلي في مشاريعك.
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) هو الملحق الرسمي لـ Visual Studio Code الخاص بـ **Intlayer**، مصمم لتحسين تجربة المطور عند العمل مع المحتوى المحلي في مشاريعك.
 
-![إضافة Intlayer لـ VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+![ملحق Intlayer لـ VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
 
-رابط الإضافة: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+رابط الملحق: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
 
 ## الميزات
 
 ### التنقل الفوري
 
-**دعم الانتقال إلى التعريف** – استخدم `Cmd+Click` (لنظام ماك) أو `Ctrl+Click` (لنظام ويندوز/لينكس) على مفتاح `useIntlayer` لفتح ملف المحتوى المقابل فورًا.  
+**دعم الانتقال إلى التعريف** – استخدم `⌘ + Click` (ماك) أو `Ctrl + Click` (ويندوز/لينكس) على مفتاح `useIntlayer` لفتح ملف المحتوى المقابل فورًا.  
 **تكامل سلس** – يعمل بسهولة مع مشاريع **react-intlayer** و **next-intlayer**.  
 **دعم متعدد اللغات** – يدعم المحتوى المحلي عبر لغات مختلفة.  
-**تكامل مع VS Code** – يندمج بسلاسة مع نظام التنقل ولوحة الأوامر في VS Code.
+**تكامل مع VS Code** – يندمج بسلاسة مع التنقل ولوحة الأوامر في VS Code.
 
 ### أوامر إدارة القواميس
 
 قم بإدارة قواميس المحتوى الخاصة بك مباشرة من VS Code:
 
-- **إنشاء القواميس** (`extension.buildDictionaries`) – توليد ملفات المحتوى بناءً على هيكل مشروعك.
-- **دفع القواميس** (`extension.pushDictionaries`) – رفع أحدث محتوى القاموس إلى مستودعك.
-- **سحب القواميس** (`extension.pullDictionaries`) – مزامنة أحدث محتوى القاموس من مستودعك إلى بيئتك المحلية.
+- **إنشاء القواميس** – توليد ملفات المحتوى بناءً على هيكل مشروعك.
+- **دفع القواميس** – رفع أحدث محتوى القاموس إلى مستودعك.
+- **سحب القواميس** – مزامنة أحدث محتوى القاموس من مستودعك إلى بيئتك المحلية.
+- **ملء القواميس** – تعبئة القواميس بالمحتوى من مشروعك.
+- **اختبار القواميس** – تحديد الترجمات المفقودة أو غير المكتملة.
 
 ### مولد إعلان المحتوى
 
-قم بسهولة بإنشاء ملفات قاموس منظمة بصيغ مختلفة:
+قم بسهولة بتوليد ملفات قاموس منظمة بصيغ مختلفة:
 
-- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
-- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
-- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
-- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+إذا كنت تعمل حاليًا على مكون، فسيتم إنشاء ملف `.content.{ts,tsx,js,jsx,mjs,cjs,json}` لك.
+
+مثال على مكون:
+
+```tsx fileName="src/components/MyComponent/index.tsx"
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("my-component");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+الملف المُولد بصيغة TypeScript:
+
+```tsx fileName="src/components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "my-component",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+الصيغ المتاحة:
+
+- **TypeScript (`.ts`)**
+- **وحدة ES (`.esm`)**
+- **CommonJS (`.cjs`)**
+- **JSON (`.json`)**
+
+### تبويب Intlayer (شريط النشاط)
+
+افتح تبويب Intlayer بالنقر على أيقونة Intlayer في شريط نشاط VS Code. يحتوي على عرضين:
+
+- **بحث**: شريط بحث مباشر لتصفية القواميس ومحتواها بسرعة. الكتابة تحدث النتائج فورًا.
+- **القواميس**: عرض شجري لبيئاتك/مشاريعك، مفاتيح القواميس، والملفات التي تساهم بالإدخالات. يمكنك:
+  - النقر على ملف لفتحه في المحرر.
+  - استخدام شريط الأدوات لتنفيذ الأوامر: بناء، سحب، دفع، تعبئة، تحديث، اختبار، وإنشاء ملف قاموس.
+  - استخدام قائمة السياق لإجراءات محددة على العنصر:
+    - على قاموس: سحب أو دفع
+    - على ملف: تعبئة القاموس
+  - عند تبديل المحررات، سيكشف العرض الشجري عن الملف المطابق إذا كان ينتمي إلى قاموس.
 
 ## التثبيت
 
@@ -60,30 +108,32 @@ slugs:
 1. افتح **VS Code**.
 2. اذهب إلى **سوق الإضافات**.
 3. ابحث عن **"Intlayer"**.
-4. اضغط على **تثبيت**.
-
-بدلاً من ذلك، قم بتثبيته عبر سطر الأوامر:
-
-```sh
-code --install-extension intlayer
-```
+4. انقر على **تثبيت**.
 
 ## الاستخدام
 
 ### التنقل السريع
 
 1. افتح مشروعًا يستخدم **react-intlayer**.
-2. حدد موقع استدعاء `useIntlayer()`، مثل:
+2. حدد مكالمة إلى `useIntlayer()`، مثل:
 
    ```tsx
    const content = useIntlayer("app");
    ```
 
-3. **انقر مع الضغط على الأمر** (`⌘+Click` على macOS) أو **انقر مع الضغط على Ctrl** (على Windows/Linux) على المفتاح (مثل `"app"`).
-4. سيقوم VS Code بفتح ملف القاموس المقابل تلقائيًا، مثل `src/app.content.ts`.
+3. **انقر مع الضغط على الأمر** (`⌘+Click` على macOS) أو **Ctrl+Click** (على Windows/Linux) على المفتاح (مثل `"app"`).
+4. سيفتح VS Code تلقائيًا ملف القاموس المقابل، مثل `src/app.content.ts`.
 
 ### إدارة قواميس المحتوى
 
+### تبويب Intlayer (شريط النشاط)
+
+استخدم التبويب الجانبي لتصفح وإدارة القواميس:
+
+- افتح أيقونة Intlayer في شريط النشاط.
+- في **البحث**، اكتب لتصفية القواميس والإدخالات في الوقت الحقيقي.
+- في **القواميس**، تصفح البيئات والقواميس والملفات. استخدم شريط الأدوات للبناء، السحب، الدفع، الملء، التحديث، الاختبار، وإنشاء ملف القاموس. انقر بزر الماوس الأيمن للحصول على إجراءات السياق (السحب/الدفع على القواميس، الملء على الملفات). يتم الكشف تلقائيًا عن ملف المحرر الحالي في الشجرة عند الاقتضاء.
+
 #### بناء القواميس
 
 قم بإنشاء جميع ملفات محتوى القاموس باستخدام:
@@ -96,7 +146,7 @@ Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
 
 #### دفع القواميس
 
-ارفع أحدث محتوى القاموس:
+قم بتحميل أحدث محتوى القاموس:
 
 1. افتح **لوحة الأوامر**.
 2. ابحث عن **Push Dictionaries**.
@@ -104,49 +154,30 @@ Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
 
 #### سحب القواميس
 
-زامن أحدث محتوى القاموس:
+مزامنة أحدث محتوى القاموس:
 
 1. افتح **لوحة الأوامر**.
 2. ابحث عن **Pull Dictionaries**.
 3. اختر القواميس التي تريد سحبها.
 
-## التطوير والمساهمة
-
-هل ترغب في المساهمة؟ نرحب بمساهمات المجتمع!
-
-رابط المستودع: https://github.com/aymericzip/intlayer-vs-code-extension
+#### ملء القواميس
 
-### البدء
-
-استنسخ المستودع وقم بتثبيت التبعيات:
-
-```sh
-git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
-cd intlayer-vs-code-extension
-npm install
-```
+املأ القواميس بالمحتوى من مشروعك:
 
-> استخدم مدير الحزم `npm` للتوافق مع حزمة `vsce` لبناء ونشر الإضافة.
-
-### التشغيل في وضع التطوير
-
-1. افتح المشروع في **VS Code**.
-2. اضغط على `F5` لفتح نافذة جديدة لـ **مضيف تطوير الإضافة**.
-
-### تقديم طلب سحب
-
-إذا قمت بتحسين الإضافة، قدم طلب سحب على [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
-
-## الملاحظات والمشاكل
-
-هل وجدت خطأً أو لديك طلب ميزة؟ افتح مشكلة في **مستودع GitHub** الخاص بنا:
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **Fill Dictionaries**.
+3. نفذ الأمر لملء القواميس.
 
-[مشاكل GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+#### اختبار القواميس
 
-## الترخيص
+تحقق من صحة القواميس واكتشف الترجمات المفقودة:
 
-تم إصدار Intlayer بموجب **رخصة MIT**.
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **Test Dictionaries**.
+3. راجع المشكلات المبلغ عنها وقم بإصلاحها حسب الحاجة.
 
-## تاريخ الوثائق
+## تاريخ الوثيقة
 
-- 5.5.10 - 2025-06-29: بداية التاريخ
+| الإصدار | التاريخ    | التغييرات     |
+| ------- | ---------- | ------------- |
+| 5.5.10  | 2025-06-29 | بداية التاريخ |