@intlayer/docs 5.5.8

package/ar/intlayer_cli.md

@@ -0,0 +1,258 @@
+# Intlayer CLI
+
+## تثبيت الحزمة
+
+قم بتثبيت الحزم الضرورية باستخدام npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> إذا كانت حزمة `intlayer` مثبتة بالفعل، فسيتم تثبيت CLI تلقائيًا. يمكنك تخطي هذه الخطوة.
+
+## حزمة intlayer-cli
+
+تهدف حزمة `intlayer-cli` إلى تحويل [تصريحات intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/dictionary/get_started.md) إلى قواميس.
+
+ستقوم هذه الحزمة بتحويل جميع ملفات intlayer، مثل `src/**/*.content.{ts|js|mjs|cjs|json}`. [اطلع على كيفية إعلان ملفات تصريح Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+لتفسير قواميس intlayer يمكنك استخدام المفسرين، مثل [react-intlayer](https://www.npmjs.com/package/react-intlayer)، أو [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## دعم ملف التكوين
+
+يدعم Intlayer تنسيقات ملفات التكوين المتعددة:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+لرؤية كيفية تكوين اللغات المتاحة أو معلمات أخرى، راجع [وثائق التكوين هنا](https://github.com/aymericzip/intlayer/blob/main/docs/ar/configuration.md).
+
+## تشغيل أوامر intlayer
+
+### بناء القواميس
+
+لبناء القواميس الخاصة بك، يمكنك تشغيل الأوامر:
+
+```bash
+npx intlayer dictionaries build
+```
+
+أو في وضع المراقبة
+
+```bash
+npx intlayer dictionaries build --watch
+```
+
+سيقوم هذا الأمر بالعثور على ملفات محتوى التصريح الخاصة بك افتراضيًا كـ `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. وبناء القواميس في دليل `.intlayer`.
+
+### دفع القواميس
+
+```bash
+npx intlayer dictionary push
+```
+
+إذا كان [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_visual_editor.md) مثبتًا، يمكنك أيضًا دفع القواميس إلى المحرر. سيسمح هذا الأمر بجعل القواميس متاحة لـ [المحرر](https://intlayer.org/dashboard). بهذه الطريقة، يمكنك مشاركة القواميس مع فريقك وتحرير المحتوى الخاص بك دون تحرير كود التطبيق الخاص بك.
+
+##### الوسائط:
+
+- `-d`, `--dictionaries`: معرفات القواميس المراد دفعها. إذا لم يتم تحديدها، سيتم دفع جميع القواميس.
+  > مثال: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+- `-r`, `--deleteLocaleDictionary`: تخطي السؤال الذي يطلب حذف مجلدات اللغات بعد دفع القواميس، وحذفها. افتراضياً، إذا كان القاموس معرفاً محلياً، فسيقوم بكتابة محتوى القواميس البعيدة.
+  > مثال: `npx intlayer dictionary push -r`
+- `-k`, `--keepLocaleDictionary`: تخطي السؤال الذي يطلب حذف مجلدات اللغات بعد دفع القواميس، والاحتفاظ بها. افتراضياً، إذا كان القاموس معرفاً محلياً، فسيقوم بكتابة محتوى القواميس البعيدة.
+  > مثال: `npx intlayer dictionary push -k`
+- `--env`: تحديد البيئة (مثل `development`، `production`).
+- `--env-file`: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- `--base-dir`: تحديد المجلد الأساسي للمشروع.
+- `--verbose`: تفعيل التسجيل المفصل للتصحيح.
+- `--git-diff`: تشغيل فقط على القواميس التي بها تغييرات غير مدفوعة.
+- `--git-diff-base`: تحديد المرجع الأساسي لمقارنة git.
+- `--git-diff-current`: تحديد المرجع الحالي لمقارنة git.
+- `--uncommitted`: تضمين التغييرات غير الملتزمة.
+- `--unpushed`: تضمين التغييرات غير المدفوعة.
+- `--untracked`: تضمين الملفات غير المتعقبة.
+
+### سحب القواميس البعيدة
+
+```bash
+npx intlayer dictionary pull
+```
+
+إذا كان [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_visual_editor.md) مثبتًا، يمكنك أيضًا سحب القواميس من المحرر. بهذه الطريقة، يمكنك الكتابة فوق محتوى القواميس الخاصة بك لتلبية احتياجات تطبيقك.
+
+##### الوسائط:
+
+- `-d, --dictionaries`: معرفات القواميس المراد سحبها. إذا لم يتم تحديدها، سيتم سحب جميع القواميس.
+  > مثال: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+- `--newDictionariesPath`: المسار إلى المجلد حيث سيتم حفظ القواميس الجديدة. إذا لم يتم تحديده، سيتم حفظ القواميس الجديدة في مجلد `./intlayer-dictionaries` للمشروع. إذا تم تحديد حقل `filePath` في محتوى القاموس الخاص بك، فلن تأخذ القواميس هذا الوسيط بعين الاعتبار وسيتم حفظها في مجلد `filePath` المحدد.
+- `--env`: تحديد البيئة (مثل `development`، `production`).
+- `--env-file`: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- `--base-dir`: تحديد المجلد الأساسي للمشروع.
+- `--verbose`: تفعيل التسجيل المفصل للتصحيح.
+
+### تدقيق القواميس
+
+```bash
+npx intlayer audit
+```
+
+يقوم هذا الأمر بتحليل ملفات تصريح المحتوى الخاصة بك للبحث عن مشكلات محتملة مثل الترجمات المفقودة أو التناقضات الهيكلية أو عدم تطابق الأنواع. إذا وجد أي مشاكل، سيقترح أو يطبق تحديثات للحفاظ على تناسق القواميس واكتمالها.
+
+##### الوسائط:
+
+- **`-f, --files [files...]`**  
+  قائمة بملفات إعلان المحتوى المحددة للتدقيق. إذا لم يتم توفيرها، سيتم تدقيق جميع ملفات `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` المكتشفة.
+
+- **`--exclude [excludedGlobs...]`**  
+  نمط globs لاستثناء من التدقيق (مثل `--exclude "src/test/**"`).
+
+- **`--source-locale [sourceLocale]`**  
+  اللغة المصدر للترجمة منها. إذا لم يتم تحديدها، سيتم استخدام اللغة الافتراضية من التكوين الخاص بك.
+
+- **`--output-locales [outputLocales...]`**  
+  اللغات المستهدفة للترجمة إليها. إذا لم يتم تحديدها، سيتم استخدام جميع اللغات من التكوين الخاص بك باستثناء اللغة المصدر.
+
+- **`--mode [mode]`**  
+  وضع الترجمة: 'complete'، 'review'، أو 'missing-only'. الافتراضي هو 'missing-only'.
+
+- **`--git-diff`**  
+  تشغيل فقط على القواميس التي بها تغييرات غير مدفوعة في مستودع git.
+
+- **`--git-diff-base`**  
+  تحديد المرجع الأساسي لمقارنة git.
+
+- **`--git-diff-current`**  
+  تحديد المرجع الحالي لمقارنة git.
+
+- **`--uncommitted`**  
+  تضمين التغييرات غير الملتزمة.
+
+- **`--unpushed`**  
+  تضمين التغييرات غير المدفوعة.
+
+- **`--untracked`**  
+  تضمين الملفات غير المتعقبة.
+
+- **`--keys [keys...]`**  
+  تصفية القواميس بناءً على المفاتيح المحددة.
+
+- **`--excluded-keys [excludedKeys...]`**  
+  استبعاد القواميس بناءً على المفاتيح المحددة.
+
+- **`--path-filter [pathFilters...]`**  
+  تصفية القواميس بناءً على نمط glob لمسارات الملفات.
+
+- **`--model [model]`**  
+  نموذج الذكاء الاصطناعي المستخدم للترجمة (مثل `gpt-3.5-turbo`).
+
+- **`--provider [provider]`**  
+  مزود الذكاء الاصطناعي المستخدم للترجمة.
+
+- **`--temperature [temperature]`**  
+  إعداد درجة الحرارة لنموذج الذكاء الاصطناعي.
+
+- **`--api-key [apiKey]`**  
+  توفير مفتاح API الخاص بك لخدمة الذكاء الاصطناعي.
+
+- **`--custom-prompt [prompt]`**  
+  توفير توجيه مخصص لتعليمات الترجمة الخاصة بك.
+
+- **`--application-context [applicationContext]`**  
+  توفير سياق إضافي لترجمة الذكاء الاصطناعي.
+
+- **`--env`**  
+  تحديد البيئة (مثل `development`، `production`).
+
+- **`--env-file [envFile]`**  
+  توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+
+- **`--base-dir`**  
+  تحديد المجلد الأساسي للمشروع.
+
+- **`--verbose`**  
+  تفعيل التسجيل المفصل للتصحيح.
+
+### إدارة التكوين
+
+#### الحصول على التكوين
+
+يقوم أمر `get configuration` باسترداد التكوين الحالي لـ Intlayer، خاصة إعدادات اللغة. هذا مفيد للتحقق من الإعداد الخاص بك.
+
+```bash
+npx intlayer config get
+```
+
+##### الوسائط:
+
+- **`--env`**: تحديد البيئة (مثلًا، `development`, `production`).
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--verbose`**: تمكين تسجيل مفصل لتصحيح الأخطاء.
+
+#### دفع التكوين
+
+يقوم أمر `push configuration` بتحميل التكوين الخاص بك إلى CMS ومحرر Intlayer. هذه الخطوة ضرورية لتمكين استخدام القواميس البعيدة في محرر Intlayer المرئي.
+
+```bash
+npx intlayer config push
+```
+
+##### الوسائط:
+
+- **`--env`**: تحديد البيئة (مثلًا، `development`, `production`).
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--verbose`**: تمكين تسجيل مفصل لتصحيح الأخطاء.
+
+من خلال دفع التكوين، يتم دمج مشروعك بالكامل مع CMS الخاص بـ Intlayer، مما يتيح إدارة سلسة للقواميس عبر الفرق.
+
+## استخدام أوامر intlayer في `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer dictionaries build",
+  "intlayer:watch": "npx intlayer dictionaries build --watch",
+  "intlayer:push": "npx intlayer dictionary push",
+  "intlayer:pull": "npx intlayer dictionary pull",
+  "intlayer:audit": "npx intlayer audit"
+}
+```
+
+## تصحيح أمر intlayer
+
+### 1. **تأكد من استخدام أحدث إصدار**
+
+قم بتنفيذ:
+
+```bash
+npx intlayer --version                  # إصدار intlayer المحلي الحالي
+npx intlayer@latest --version          # أحدث إصدار من intlayer
+```
+
+### 2. **تحقق مما إذا كان الأمر مسجلاً**
+
+يمكنك التحقق باستخدام:
+
+```bash
+npx intlayer --help      # يعرض قائمة بالأوامر المتاحة ومعلومات الاستخدام
+```
+
+### 3. **أعد تشغيل الطرفية**
+
+أحياناً يكون من الضروري إعادة تشغيل الطرفية للتعرف على الأوامر الجديدة.
+
+### 4. **امسح ذاكرة التخزين المؤقت لـ npx (إذا كنت عالقاً في إصدار قديم)**
+
+```bash
+npx clear-npx-cache
+```

package/ar/intlayer_visual_editor.md

@@ -0,0 +1,210 @@
+# وثائق محرر Intlayer البصري
+
+<iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+محرر Intlayer البصري هو أداة تتيح لك التفاعل مع ملفات إعلان المحتوى الخاصة بموقعك باستخدام محرر بصري.
+
+![واجهة محرر Intlayer البصري](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+حزمة `intlayer-editor` تعتمد على Intlayer ومتاحة لتطبيقات JavaScript، مثل React (Create React App)، Vite + React، و Next.js.
+
+## المحرر البصري مقابل CMS
+
+محرر Intlayer البصري هو أداة تتيح لك إدارة المحتوى الخاص بك في محرر بصري للقواميس المحلية. بمجرد إجراء تغيير، سيتم استبدال المحتوى في قاعدة الكود. هذا يعني أن التطبيق سيتم إعادة بنائه وستتم إعادة تحميل الصفحة لعرض المحتوى الجديد.
+
+على النقيض من ذلك، فإن [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_CMS.md) هو أداة تتيح لك إدارة المحتوى الخاص بك في محرر بصري للقواميس البعيدة. بمجرد إجراء تغيير، لن يؤثر المحتوى على قاعدة الكود الخاصة بك. وسيعرض الموقع تلقائيًا المحتوى الذي تم تغييره.
+
+## دمج Intlayer في تطبيقك
+
+لمزيد من التفاصيل حول كيفية دمج Intlayer، راجع القسم المناسب أدناه:
+
+### الدمج مع Next.js
+
+لدمج مع Next.js، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_nextjs_15.md).
+
+### الدمج مع Create React App
+
+لدمج مع Create React App، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_create_react_app.md).
+
+### الدمج مع Vite + React
+
+لدمج مع Vite + React، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_vite+react.md).
+
+## كيفية عمل محرر Intlayer
+
+المحرر البصري في تطبيق يتضمن شيئين:
+
+- تطبيق واجهة أمامية يعرض موقعك داخل iframe. إذا كان موقعك يستخدم Intlayer، سيكتشف المحرر البصري محتواك تلقائيًا، وسيسمح لك بالتفاعل معه. بمجرد إجراء تعديل، ستتمكن من تنزيل تغييراتك.
+
+- بمجرد النقر على زر التنزيل، سيرسل المحرر البصري طلبًا إلى الخادم لاستبدال ملفات إعلان المحتوى الخاصة بك بالمحتوى الجديد (أينما تم إعلان هذه الملفات في مشروعك).
+
+> لاحظ أنه في الوقت الحالي، سيكتب محرر Intlayer ملفات إعلان المحتوى الخاصة بك كملفات JSON.
+
+## التثبيت
+
+بمجرد تكوين Intlayer في مشروعك، قم ببساطة بتثبيت `intlayer-editor` كاعتماد تطوير:
+
+```bash packageManager="npm"
+npm install intlayer-editor --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-editor --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-editor --save-dev
+```
+
+## التكوين
+
+في ملف تكوين Intlayer الخاص بك، يمكنك تخصيص إعدادات المحرر:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... إعدادات التكوين الأخرى
+  editor: {
+    /**
+     * مطلوب
+     * عنوان URL للتطبيق.
+     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     * مثال: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * اختياري
+     * الافتراضي هو `true`. إذا كان `false`، فإن المحرر غير نشط ولا يمكن الوصول إليه.
+     * يمكن استخدامه لتعطيل المحرر لبيئات محددة لأسباب أمنية، مثل الإنتاج.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * اختياري
+     * الافتراضي هو `8000`.
+     * منفذ خادم المحرر.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * اختياري
+     * الافتراضي هو "http://localhost:8000"
+     * عنوان URL لخادم المحرر.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... إعدادات التكوين الأخرى
+  editor: {
+    /**
+     * مطلوب
+     * عنوان URL للتطبيق.
+     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     * مثال: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * اختياري
+     * الافتراضي هو `true`. إذا كان `false`، فإن المحرر غير نشط ولا يمكن الوصول إليه.
+     * يمكن استخدامه لتعطيل المحرر لبيئات محددة لأسباب أمنية، مثل الإنتاج.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * اختياري
+     * الافتراضي هو `8000`.
+     * منفذ خادم المحرر.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * اختياري
+     * الافتراضي هو "http://localhost:8000"
+     * عنوان URL لخادم المحرر.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... إعدادات التكوين الأخرى
+  editor: {
+    /**
+     * مطلوب
+     * عنوان URL للتطبيق.
+     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * اختياري
+     * الافتراضي هو `8000`.
+     * منفذ خادم المحرر.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * اختياري
+     * الافتراضي هو "http://localhost:8000"
+     * عنوان URL لخادم المحرر.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+    /**
+     * اختياري
+     * الافتراضي هو `true`. إذا كان `false`، فإن المحرر غير نشط ولا يمكن الوصول إليه.
+     * يمكن استخدامه لتعطيل المحرر لبيئات محددة لأسباب أمنية، مثل الإنتاج.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+  },
+};
+
+module.exports = config;
+```
+
+> لمشاهدة جميع المعلمات المتاحة، راجع [وثائق التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/ar/configuration.md).
+
+## استخدام المحرر
+
+1. عند تثبيت المحرر، يمكنك بدء تشغيله باستخدام الأمر التالي:
+
+   ```bash packageManager="npm"
+   npx intlayer-editor start
+   ```
+
+   ```bash packageManager="yarn"
+   yarn intlayer-editor start
+   ```
+
+   ```bash packageManager="pnpm"
+   pnpm intlayer-editor start
+   ```
+
+   > **لاحظ أنه يجب تشغيل تطبيقك بالتوازي.** يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في تكوين المحرر (`applicationURL`).
+
+2. ثم افتح عنوان URL المقدم. الافتراضي هو `http://localhost:8000`.
+
+   يمكنك عرض كل حقل مفهرس بواسطة Intlayer عن طريق التمرير فوق المحتوى الخاص بك باستخدام المؤشر.
+
+   ![التمرير فوق المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_hover_content.png)
+
+3. إذا تم تحديد محتواك، يمكنك الضغط عليه مطولاً لعرض درج التعديل.
+
+## التصحيح
+
+إذا واجهت أي مشاكل مع المحرر البصري، تحقق من التالي:
+
+- المحرر البصري والتطبيق يعملان.
+
+- تم إعداد [تكوين المحرر](https://intlayer.org/doc/concept/configuration#editor-configuration) بشكل صحيح في ملف تكوين Intlayer الخاص بك.
+
+  - الحقول المطلوبة:
+    - يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في تكوين المحرر (`applicationURL`).
+
+- يستخدم المحرر البصري iframe لعرض موقعك. تأكد من أن سياسة أمان المحتوى (CSP) لموقعك تسمح بعنوان URL الخاص بـ CMS كـ `frame-ancestors` ('http://localhost:8000' افتراضيًا). تحقق من وحدة تحكم المحرر لأي خطأ.

package/ar/intlayer_with_angular.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/intlayer_with_vite+preact.md