@intlayer/docs 7.5.10 → 7.5.12

package/docs/ar/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: أمر CI
+description: تعلم كيفية استخدام أمر Intlayer CI لتشغيل أوامر Intlayer مع بيانات الاعتماد المحقونة تلقائياً في خطوط أنابيب CI/CD والمستودعات الأحادية.
+keywords:
+  - CI
+  - CI/CD
+  - الأتمتة
+  - المستودع الأحادي
+  - بيانات الاعتماد
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: إضافة أمر CI
+---
+
+# أمر CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+تم تصميم أمر CI للأتمتة وخطوط أنابيب CI/CD. يقوم بحقن بيانات الاعتماد تلقائياً من متغير البيئة `INTLAYER_PROJECT_CREDENTIALS` ويمكنه تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي.
+
+## كيفية العمل
+
+يعمل أمر CI في وضعين:
+
+1. **وضع المشروع الواحد**: إذا كان الدليل الحالي يطابق أحد مسارات المشاريع في `INTLAYER_PROJECT_CREDENTIALS`، فإنه يشغل الأمر فقط لهذا المشروع المحدد.
+
+2. **وضع التكرار**: إذا لم يتم اكتشاف سياق مشروع محدد، فإنه يتكرر عبر جميع المشاريع المُكوّنة ويشغل الأمر لكل واحد منها.
+
+## متغير البيئة
+
+يتطلب الأمر تعيين متغير البيئة `INTLAYER_PROJECT_CREDENTIALS`. يجب أن يحتوي هذا المتغير على كائن JSON يقوم بتعيين مسارات المشاريع إلى بيانات اعتمادها:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## اكتشاف مدير الحزم
+
+يكتشف أمر CI تلقائياً مدير الحزم المستخدم (npm أو yarn أو pnpm أو bun) بناءً على متغير البيئة `npm_config_user_agent` ويستخدم الأمر المناسب لتنفيذ Intlayer.
+
+## الوسائط
+
+- **`<command...>`**: أمر Intlayer المراد تنفيذه (على سبيل المثال، `fill` أو `push` أو `build`). يمكنك تمرير أي أمر Intlayer ووسائطه.
+
+  > مثال: `npx intlayer ci fill --verbose`
+  >
+  > مثال: `npx intlayer ci push`
+  >
+  > مثال: `npx intlayer ci build`
+
+## أمثلة
+
+### تشغيل أمر في وضع المشروع الواحد
+
+إذا كنت في دليل مشروع يطابق أحد المسارات في `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+سيقوم هذا بتشغيل أمر `fill` مع حقن بيانات الاعتماد تلقائياً لمشروع `packages/app`.
+
+### تشغيل أمر عبر جميع المشاريع
+
+إذا كنت في دليل لا يطابق أي مسار مشروع، سيتكرر الأمر عبر جميع المشاريع المُكوّنة:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+سيقوم هذا بتشغيل أمر `push` لكل مشروع مُكوّن في `INTLAYER_PROJECT_CREDENTIALS`.
+
+### تمرير علامات إضافية
+
+يمكنك تمرير أي علامات إلى أمر Intlayer الأساسي:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### الاستخدام في خطوط أنابيب CI/CD
+
+في تكوين CI/CD الخاص بك (على سبيل المثال، GitHub Actions أو GitLab CI)، قم بتعيين `INTLAYER_PROJECT_CREDENTIALS` كسر:
+
+```yaml
+# مثال GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: ملء القواميس
+    run: npx intlayer ci fill
+```
+
+## معالجة الأخطاء
+
+- إذا لم يتم تعيين `INTLAYER_PROJECT_CREDENTIALS`، فسيخرج الأمر مع خطأ.
+- إذا لم يكن `INTLAYER_PROJECT_CREDENTIALS` JSON صالحاً، فسيخرج الأمر مع خطأ.
+- إذا لم يكن مسار المشروع موجوداً، فسيتم تخطيه مع تحذير.
+- إذا فشل أي مشروع، فسيخرج الأمر برمز حالة غير صفري.
+
+## حالات الاستخدام
+
+- **أتمتة المستودع الأحادي**: تشغيل أوامر Intlayer عبر مشاريع متعددة في مستودع أحادي
+- **خطوط أنابيب CI/CD**: أتمتة إدارة القواميس في سير عمل التكامل المستمر
+- **العمليات المجمعة**: تنفيذ نفس العملية على مشاريع Intlayer متعددة في وقت واحد
+- **إدارة الأسرار**: إدارة بيانات الاعتماد بشكل آمن لعدة مشاريع باستخدام متغيرات البيئة
+
+## أفضل ممارسات الأمان
+
+- قم بتخزين `INTLAYER_PROJECT_CREDENTIALS` كأسرار مشفرة في منصة CI/CD الخاصة بك
+- لا تقم أبداً بإيداع بيانات الاعتماد في التحكم بالإصدارات
+- استخدم بيانات اعتماد خاصة بالبيئة لبيئات النشر المختلفة
+- قم بتدوير بيانات الاعتماد بانتظام

package/docs/ar/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: اكتشف كيفية استخدام واجهة الأوامر Intlayer CLI لإدارة موقعك متعدد اللغات. اتبع الخطوات في هذه الوثائق الإلكترونية لإعداد مشروعك في دقائق قليلة.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: إضافة أمر projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: إضافة أمر init
@@ -119,6 +122,7 @@ bun add intlayer-cli -g
 - **[بناء القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/build.md)** - بناء قواميسك من ملفات إعلان المحتوى
 - **[مراقبة القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/watch.md)** - مراقبة التغييرات وبناء القواميس تلقائيًا
 - **[التحقق من إصدار CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/version.md)** - التحقق من إصدار Intlayer CLI المثبت
+- **[قائمة المشاريع](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/list_projects.md)** - قائمة بجميع مشاريع Intlayer في دليل أو مستودع git
 
 ### إدارة القواميس
 
@@ -166,6 +170,7 @@ bun add intlayer-cli -g
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ bun add intlayer-cli -g
 >
 > - `npx intlayer list` بدلاً من `npx intlayer content list`
 > - `npx intlayer test` بدلاً من `npx intlayer content test`
+> - `npx intlayer projects-list` أو `npx intlayer pl` بدلاً من `npx intlayer projects list`

package/docs/ar/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: قائمة ملفات إعلان المحتوى
 description: تعلّم كيفية سرد جميع ملفات إعلان المحتوى في مشروعك.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: إضافة خيار الإخراج المطلق لأمر القائمة
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: إضافة خيار إخراج JSON لأمر القائمة
 ---
 
 # قائمة ملفات إعلان المحتوى
@@ -27,14 +34,36 @@ npx intlayer content list
 
 يعرض هذا الأمر جميع ملفات إعلان المحتوى في مشروعك، مع عرض مفاتيح القاموس الخاصة بها ومسارات الملفات. وهو مفيد للحصول على نظرة عامة على جميع ملفات المحتوى الخاصة بك والتحقق من اكتشافها بشكل صحيح بواسطة Intlayer.
 
-## مثال:
+## الوسائط:
+
+- **`--json`**: إخراج النتائج بتنسيق JSON بدلاً من النص المنسق. مفيد للبرمجة النصية والوصول البرمجي.
+
+  > مثال: `npx intlayer content list --json`
+
+## أمثلة:
+
+### سرد ملفات إعلان المحتوى:
 
 ```bash
 npx intlayer content list
 ```
 
+### الإخراج بتنسيق JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### الإخراج كمسارات مطلقة:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## مثال على الإخراج:
 
+### الإخراج المنسق:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 إجمالي ملفات إعلان المحتوى: 3
 ```
 
+### إخراج JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 سيقوم هذا الأمر بإخراج:
 
 - قائمة منسقة بجميع ملفات إعلان المحتوى مع مفاتيحها ومسارات الملفات النسبية

package/docs/ar/cli/list_projects.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: قائمة مشاريع Intlayer
+description: تعرّف كيف تُدرَج جميع مشاريع Intlayer في دليل أو مستودع git.
+keywords:
+  - قائمة
+  - مشاريع
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: إضافة خيار الإخراج المطلق إلى أمر list projects
+---
+
+# قائمة مشاريع Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+يبحث هذا الأمر عن جميع مشاريع Intlayer ويسردها عن طريق العثور على الأدلة التي تحتوي على ملفات تكوين Intlayer. يكون هذا مفيدًا لاكتشاف جميع مشاريع Intlayer في monorepo أو workspace أو مستودع git.
+
+## الاختصارات:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## الوسائط:
+
+- **`--base-dir [path]`**: حدد الدليل الأساسي للبحث منه. الافتراضي هو دليل العمل الحالي.
+
+  > مثال: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > مثال: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: البحث من جذر git بدلاً من الدليل الأساسي. هذا مفيد للعثور على جميع مشاريع Intlayer في monorepo أو مستودع git.
+
+  > مثال: `npx intlayer projects list --git-root`
+
+- **`--json`**: إخراج النتائج بتنسيق JSON بدلاً من النص المنسق. مفيد للبرمجة النصية والوصول البرمجي.
+
+  > مثال: `npx intlayer projects list --json`
+
+- **`--absolute`**: إخراج النتائج كمسارات مطلقة بدلاً من المسارات النسبية.
+
+  > مثال: `npx intlayer projects list --absolute`
+
+## كيف يعمل:
+
+يبحث الأمر عن ملفات تكوين Intlayer في الدليل المحدد (أو جذر git إذا تم استخدام `--git-root`). يبحث عن أنماط ملفات التكوين التالية:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+يُعتبر كل دليل يحتوي على أحد هذه الملفات مشروع Intlayer وسيتم إدراجه في الناتج.
+
+## أمثلة:
+
+### سرد المشاريع في الدليل الحالي:
+
+```bash
+npx intlayer projects list
+```
+
+### قائمة المشاريع في دليل محدد:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### قائمة جميع المشاريع في مستودع git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### باستخدام الاسم المختصر:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### الإخراج بتنسيق JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## مثال على المخرجات:
+
+### الإخراج المنسق:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### إخراج JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## حالات الاستخدام:
+
+- **إدارة Monorepo**: اكتشاف جميع مشاريع Intlayer في هيكلية monorepo
+- **اكتشاف المشاريع**: العثور على جميع المشاريع المدعومة بواسطة Intlayer في مساحة العمل
+- **CI/CD**: التحقق من مشاريع Intlayer في سير عمل مؤتمت
+- **التوثيق**: توليد توثيق يسرد جميع المشاريع التي تستخدم Intlayer
+- **التوثيق**: إنشاء توثيق يسرد جميع المشاريع التي تستخدم Intlayer
+
+تُرجع المخرجات مسارات مطلقة لكل دليل مشروع، مما يسهل التنقل إليها أو تشغيل عمليات نصية (scripting) على عدة مشاريع Intlayer.

package/docs/ar/intlayer_CMS.md

@@ -71,6 +71,26 @@ history:
 
 ## التهيئة
 
+قم بتشغيل الأمر التالي لتسجيل الدخول إلى Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+سيؤدي هذا إلى فتح المتصفح الافتراضي الخاص بك لإكمال عملية المصادقة والحصول على بيانات الاعتماد اللازمة (معرف العميل وسر العميل) لاستخدام خدمات Intlayer.
+
 في ملف تهيئة Intlayer الخاص بك، يمكنك تخصيص إعدادات نظام إدارة المحتوى:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ar/intlayer_with_next-i18next.md

@@ -584,7 +584,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/ar/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### الخطوة 2: تكوين مشروعك
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 قم بإنشاء ملف تكوين لتحديد لغات تطبيقك:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ar/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### الخطوة 2: تكوين مشروعك
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 أنشئ ملف تكوين لتكوين لغات تطبيقك:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/ar/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### الخطوة 2: تكوين مشروعك
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 أنشئ ملف تكوين لتحديد لغات تطبيقك:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"