@intlayer/docs 9.5.6 → 9.5.8

package/docs/ar/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-09-12
+updatedAt: 2026-09-23
 title: CLI - جميع أوامر Intlayer CLI لموقعك متعدد اللغات
 description: اكتشف كيفية استخدام Intlayer CLI لإدارة موقعك متعدد اللغات. اتبع الخطوات الواردة في هذه الوثائق عبر الإنترنت لإعداد مشروعك في دقائق معدودة.
 keywords:
@@ -17,6 +17,12 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "إضافة أمر upgrade"
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "إضافة أمر init infra"
   - version: 9.5.2
     date: 2026-09-12
     changes: "استبدال الأمر `ci` بالعلامة `--ci`"
@@ -151,6 +157,8 @@ bun add intlayer-cli -g
 ### التكوين
 
 - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/init.md)** - إعداد Intlayer في مشروعك بتكوين تلقائي
+- **[إعداد البنية التحتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/infra.md)** - تثبيت تطبيق سطح المكتب أو الاستضافة الذاتية لـ CMS باستخدام Docker (الكل في واحد أو Compose)
+- **[ترقية حزم Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/upgrade.md)** - سرد حزم Intlayer لكل `package.json` وترقيتها إلى أحدث إصدار
 - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/configuration.md)** - الحصول على تكوين Intlayer الخاص بك وإرساله إلى CMS
 
 ### إدارة الوثائق
@@ -177,6 +185,8 @@ bun add intlayer-cli -g
 ```json fileName="package.json"
 "scripts": {
   "intlayer:init": "npx intlayer init",
+  "intlayer:infra": "npx intlayer init infra",
+  "intlayer:upgrade": "npx intlayer upgrade",
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",

package/docs/ar/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: تعرف على كيفية استخدام أمر init infra في واجهة سطر أوامر Intlayer لتثبيت تطبيق سطح المكتب أو الاستضافة الذاتية لـ Intlayer CMS باستخدام Docker (حاوية الكل في واحد أو مكدس Docker Compose).
+keywords:
+  - CLI
+  - البنية التحتية
+  - الاستضافة الذاتية
+  - تطبيق سطح المكتب
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "إضافة أمر init infra"
+author: aymericzip
+---
+
+# أمر Intlayer CLI Init Infra
+
+## الوصف
+
+يقوم أمر `init infra` بإعداد البنية التحتية لـ Intlayer على جهازك. يقوم بتنزيل أداة التثبيت المستضافة لمنصتك (`https://intlayer.org/install.sh` على macOS / Linux، و`https://intlayer.org/install.ps1` على Windows) وتشغيلها مع إرفاق الطرفية، حتى تصلك قائمة أداة التثبيت ومخرجات التقدم دون تغيير.
+
+تسألك أداة التثبيت عن كيفية تشغيل Intlayer:
+
+- **تطبيق سطح المكتب**: يقوم بتنزيل لوحة التحكم الأصلية لنظام التشغيل والمعالج لديك وفتحها أو تثبيتها. يتصل إصدار سطح المكتب بالواجهة الخلفية لـ Intlayer Cloud.
+- **Docker الكل في واحد**: لوحة التحكم + API + MongoDB + Redis + MinIO في حاوية واحدة مدعومة بوحدة تخزين واحدة. يكتب `./intlayer.env` بالأسرار المُنشأة ويسحب صورة `intlayer/cms-all`.
+- **Docker Compose**: حاوية واحدة لكل خدمة، للاستضافة الذاتية القابلة للتوسع. يكتب `docker-compose.yml` و`.env` في `./intlayer/` ويسحب الصور.
+
+أداة التثبيت المستضافة هي المصدر الوحيد للحقيقة لعملية الإعداد: يقوم CLI بتشغيلها بدلاً من إعادة تنفيذ نفس الخطوات، لذا فإن `npx intlayer init infra` و`curl -fsSL https://intlayer.org/install.sh | sh` يقومان بنفس الشيء تمامًا.
+
+## الاستخدام
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+يتم تقديم نفس الخطوة من قائمة التحقق الخاصة بـ `npx intlayer init --interactive`، تحت **البنية التحتية (تطبيق سطح المكتب / الاستضافة الذاتية)**.
+
+## الخيارات
+
+- `-m, --mode <mode>` - اختياري. تخطي قائمة أداة التثبيت وتشغيل وضع معين مباشرة. القيم المقبولة: `desktop` أو `docker` (الكل في واحد) أو `compose`. أي قيمة أخرى ستؤدي إلى الخروج مع إظهار خطأ يسرد الأوضاع المقبولة.
+
+## أمثلة
+
+### اختر الوضع بشكل تفاعلي
+
+```bash
+npx intlayer init infra
+```
+
+### تثبيت تطبيق سطح المكتب
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### الاستضافة الذاتية باستخدام حاوية الكل في واحد
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### الاستضافة الذاتية باستخدام Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## مثال على المخرجات
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## إعدادات أداة التثبيت
+
+تقرأ أداة التثبيت بعض متغيرات البيئة، والتي يمررها CLI كما هي. اضبطها في الطرفية قبل تشغيل الأمر:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| المتغير                   | الافتراضي                 | ينطبق على | الوصف                                            |
+| ------------------------- | ------------------------- | --------- | ------------------------------------------------ |
+| `INTLAYER_MODE`           | _(يُسأل عنه)_             | الكل      | `desktop` أو `docker` أو `compose`، نفس `--mode` |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop   | مكان حفظ أداة تثبيت التطبيق                      |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker    | صورة الكل في واحد المراد سحبها                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker    | مكان كتابة ملف البيئة                            |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker    | اسم الحاوية                                      |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker    | وحدة تخزين مسماة مثبتة في `/data`                |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker    | منفذ المضيف للوحة التحكم                         |
+| `INTLAYER_API_PORT`       | `3100`                    | docker    | منفذ المضيف لـ API                               |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker    | منفذ المضيف لـ MinIO S3 API                      |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker    | منفذ المضيف لوحدة تحكم MinIO                     |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose   | مكان كتابة `docker-compose.yml` و`.env`          |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | كلاهما    | مرجع Git الذي يتم جلب ملف compose وقالب env منه  |
+
+> تغير متغيرات المنافذ جانب **المضيف** فقط من التعيين. تحتوي الصور المنشورة على `http://localhost:3000` و`http://localhost:3100` و`http://localhost:9000` مجمعة في حزمة لوحة التحكم، لذا احتفظ بالإعدادات الافتراضية ما لم تقم ببناء صورك الخاصة: راجع [دليل الاستضافة الذاتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md#limitations).
+
+## المتطلبات
+
+- **تطبيق سطح المكتب** يحتاج إلى [Node.js](https://nodejs.org): يدمج التطبيق خادم لوحة التحكم ويبدأه باستخدام الملف الثنائي `node` الخاص بالجهاز.
+- **أوضاع Docker** تحتاج إلى [Docker](https://docs.docker.com/get-docker/) (Docker Desktop مع الواجهة الخلفية WSL 2 على Windows). يحتاج وضع Compose أيضًا إلى المكون الإضافي `docker compose`.
+
+## ملاحظات
+
+- إعادة تشغيل الأمر آمنة: لا يتم استبدال ملف البيئة الموجود أبدًا، مما يجعله أيضًا مسارًا للترقية (تسحب أداة التثبيت أحدث الصور وتحتفظ بأسرارك).
+- يتم تنزيل أداة التثبيت إلى دليل مؤقت ويتم حذفها بمجرد الخروج، مهما كانت النتيجة.
+- رمز خروج الأمر هو رمز خروج أداة التثبيت. إذا فشل التنزيل نفسه، يطبع CLI أمر `curl … | sh` (أو `irm … | iex`) المكافئ لتشغيل أداة التثبيت مباشرة.
+- لا تزال أوضاع Docker بحاجة إلى خدمة بريد إلكتروني لإرسال رسائل تسجيل الدخول. بعد انتهاء التثبيت، قم بتهيئة Resend أو SMTP في ملف البيئة المنشأ: راجع [خدمة البريد العالمية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md#global-mailer).
+
+## ذات صلة
+
+- [دليل الاستضافة الذاتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md) - البنية وخطوات التشغيل الأولى والقيود لكل وضع
+- [تهيئة Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/init.md) - أمر `init` الأصلي وقائمة التحقق التفاعلية الخاصة به
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) - وظائف لوحة التحكم التي قمت بتثبيتها للتو

package/docs/ar/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: تهيئة Intlayer
 description: تعرف على كيفية تهيئة Intlayer في مشروعك.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "إضافة الأمر الفرعي init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "إضافة خيار --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 سيؤدي هذا إلى إعداد جميع ملفات التكوين ولكنه لن يعدل ملف `.gitignore` الخاص بك.
 
+### إعداد البنية التحتية (تطبيق سطح المكتب أو الاستضافة الذاتية):
+
+```bash
+npx intlayer init infra
+```
+
+يقوم بتنزيل وتشغيل أداة التثبيت المستضافة (`https://intlayer.org/install.sh`، أو `install.ps1` على Windows)، والتي تسألك عن كيفية تشغيل Intlayer:
+
+- **تطبيق سطح المكتب** - يقوم بتثبيت لوحة التحكم الأصلية على جهازك، المتصلة بـ Intlayer Cloud.
+- **Docker الكل في واحد** - لوحة التحكم + API + MongoDB + Redis + MinIO في حاوية واحدة.
+- **Docker Compose** - حاوية واحدة لكل خدمة، للاستضافة الذاتية القابلة للتوسع.
+
+تخطي القائمة باستخدام `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+يتم تقديم نفس الخطوة بواسطة `npx intlayer init --interactive`. راجع [مرجع `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/infra.md) لمعرفة إعدادات أداة التثبيت، و[دليل الاستضافة الذاتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md) لمعرفة ما يقوم كل وضع بإعداده.
+
 ## مثال على المخرجات:
 
 ```bash

package/docs/ar/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - ترقية حزم Intlayer
+description: تعرف على كيفية استخدام أمر upgrade في Intlayer CLI لسرد كل حزمة Intlayer في مشروعك أو monorepo وترقيتها إلى أحدث إصدار.
+keywords:
+  - CLI
+  - Upgrade
+  - ترقية
+  - Packages
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "إضافة أمر upgrade"
+author: aymericzip
+---
+
+# ترقية حزم Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+يسرد الأمر `upgrade` حزم Intlayer المعلنة في كل `package.json` من مشروعك، بما في ذلك مساحات عمل (workspaces) الـ monorepo، ويقوم بترقيتها إلى أحدث إصدار منشور. وهو ينفذ نفس خطوة ترقية الحزم الخاصة بـ `intlayer init` بشكل مستقل.
+
+## الوسيطات:
+
+- `--project-root [projectRoot]` - اختياري. دليل جذر المشروع. افتراضيًا، يبدأ الأمر من أقرب `package.json` أعلى دليل العمل الحالي.
+- `--dry-run` - اختياري. يسرد الحزم وإصدارها المستهدف دون تعديل أي ملف.
+- `--tag <tag>` - اختياري. npm dist-tag للترقية إليه (على سبيل المثال `canary`). الافتراضي هو `latest`.
+
+## ما يقوم به:
+
+1. **يسرد حزم Intlayer** - يفحص كل `package.json` في المشروع (متجاوزًا `node_modules` ومخرجات البناء) بحثًا عن تبعيات و devDependencies الخاصة بـ `intlayer` و `@intlayer/*` و `*-intlayer` و `intlayer-*`.
+2. **يجلب الإصدار المستهدف** - يقرأ إصدار الـ dist-tag المحدد (افتراضيًا `latest`) لكل حزمة من سجل npm.
+3. **يعيد كتابة النطاقات** - يحدّث كل نطاق قديم في مكانه، مع الحفاظ على المعامل الخاص به (`^` أو `~` أو لا شيء) ومسافات بادئة الملف.
+4. **يثبت مرة واحدة** - ينفذ عملية تثبيت واحدة من جذر مساحة العمل (أقرب دليل يحتوي على lock file)، باستخدام مدير الحزم المالك لملف القفل:
+
+| ملف القفل (Lock file)           | الأمر          |
+| ------------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`        | `bun install`  |
+| `pnpm-lock.yaml`                | `pnpm install` |
+| `yarn.lock`                     | `yarn install` |
+| `package-lock.json` أو بدون قفل | `npm install`  |
+
+إذا لم يكن هناك ملف قفل، فسيتم استخدام حقل `packageManager` في `package.json` (على سبيل المثال `"bun@1.2.0"`) قبل الرجوع إلى npm.
+
+النطاقات التي لا تشير إلى السجل، مثل `workspace:*` أو `file:` أو `link:` أو `catalog:` أو عناوين git URL، لا يتم تعديلها أبدًا.
+
+## أمثلة:
+
+### سرد الترقيات المتاحة دون تطبيقها:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### الترقية إلى إصدار canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## مثال للمخرجات:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## ملاحظات:
+
+- شغّل الأمر من جذر المستودع الخاص بك لترقية كل مساحة عمل. شغّله من مساحة عمل معينة لترقية تلك المساحة فقط.
+- الحزم التي لا يمكن جلب إصدارها (غير متصل بالإنترنت، حزمة خاصة أو غير منشورة) يتم سردها وتُترك دون تغيير.
+- إذا فشل التثبيت، فسيتم الاحتفاظ بالنطاقات التي تمت ترقيتها في `package.json`. شغّل أمر التثبيت الخاص بمدير الحزم يدويًا.

package/docs/ar/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-01-22
+updatedAt: 2026-09-21
 title: محتوى HTML
 description: تعلّم كيفية إعلان واستخدام محتوى HTML مع مكونات مخصصة في Intlayer. اتبع هذه الوثائق لتضمين محتوى غني يشبه HTML مع استبدال المكونات ديناميكيًا في مشروعك متعدد اللغات.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
 slugs:
   - doc
   - concept
@@ -236,6 +238,83 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    في Remix 3، يتم تحليل عقد HTML إلى سلسلة HTML. قم بحقنها باستخدام خاصية `innerHTML` في Remix JSX، أو باستخدام `html.raw` في عرض `html-template`.
+
+    ```tsx fileName="src/views/home.tsx"
+    import { useIntlayer } from "remix-intlayer";
+
+    export const HomePage = () => () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return <div innerHTML={myHtmlContent.value} />;
+    };
+    ```
+
+    ```ts fileName="src/views/home.ts"
+    import { html } from "remix/html-template";
+    import { useIntlayer } from "remix-intlayer";
+
+    export const renderHomePage = () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return html.raw`<div>${myHtmlContent.value}</div>`;
+    };
+    ```
+
+    > يقوم Remix بتهريب القيم المدرجة افتراضيًا. `innerHTML` و `html.raw` هما خيارا إلغاء الاشتراك، وهو ما تحتاجه سلسلة HTML.
+
+    استخدم طريقة `.use()` لتجاوز العلامات أو تعيين المكونات المخصصة. التجاوزات هي دوال تُرجع سلسلة HTML:
+
+    ```tsx
+    <div
+      innerHTML={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    في Astro، يتم تحليل عقد HTML إلى سلسلة HTML. قم بحقنها باستخدام توجيه `set:html` في القالب، أو باستخدام `innerHTML` في `<script>` من جانب العميل.
+
+    ```astro fileName="src/pages/index.astro"
+    ---
+    import { useIntlayer } from "astro-intlayer";
+
+    const { myHtmlContent } = useIntlayer("app");
+    ---
+
+    <div set:html={myHtmlContent.value} />
+    ```
+
+    ```astro fileName="src/components/Content.astro"
+    <div id="content"></div>
+
+    <script>
+      import { useIntlayer } from "astro-intlayer";
+
+      const { myHtmlContent } = useIntlayer("app");
+
+      document.querySelector("#content")!.innerHTML = myHtmlContent.value;
+    </script>
+    ```
+
+    > يقوم Astro بتهريب `{التعبيرات}` افتراضيًا. `set:html` هو خيار إلغاء الاشتراك، وهو ما تحتاجه سلسلة HTML.
+
+    استخدم طريقة `.use()` لتجاوز العلامات أو تعيين المكونات المخصصة. التجاوزات هي دوال تُرجع سلسلة HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## التكوين العام باستخدام `HTMLProvider`
@@ -471,6 +550,41 @@ const myContent = html(
     > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    لا يحتوي Remix على شجرة مكونات للاحتفاظ بمزود، لذلك يتم تثبيت التكوين مرة واحدة، كعنصر فريد (singleton)، عند بدء تشغيل الخادم. يقوم بتكوين أداة العرض التي تُرجعها `useHTMLRenderer()`. يتم عرض عقد `html` التي تُرجعها `useIntlayer` كما هي؛ قم بتجاوز علاماتها لكل عقدة باستخدام `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > استخدم `installIntlayerHTMLDynamic(async () => …)` لتحميل أداة العرض بشكل متكاسل؛ يتم تشغيل أداة التحميل عند الاستدعاء الأول فقط.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    لا يحتوي Astro على شجرة مكونات للاحتفاظ بمزود، لذلك يتم تثبيت التكوين مرة واحدة، كعنصر فريد (singleton)، في البرمجيات الوسيطة (الخادم) وفي `<script>` من جانب العميل (المتصفح). يقوم بتكوين أداة العرض التي تُرجعها `useHTMLRenderer()`. يتم عرض عقد `html` التي تُرجعها `useIntlayer` كما هي؛ قم بتجاوز علاماتها لكل عقدة باستخدام `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // يتم التشغيل مرة واحدة عند بدء تشغيل الخادم؛ يتم تسجيل برمجية Intlayer الوسيطة نفسها
+    // بواسطة التكامل قبل هذا الملف.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > استخدم `installIntlayerHTMLDynamic(async () => …)` لتحميل أداة العرض بشكل متكاسل؛ يتم تشغيل أداة التحميل عند الاستدعاء الأول فقط.
+
+  </Tab>
 </Tabs>
 
 ### التصيير اليدوي والأدوات المتقدمة
@@ -643,15 +757,69 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Hook `useHTMLRenderer()`
+
+    احصل على دالة عرض مهيأة مسبقًا بواسطة `installIntlayerHTML()`. تُرجع سلسلة HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### أداة `renderHTML()`
+
+    أداة قائمة بذاتها تتجاهل التكوين العام.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Hook `useHTMLRenderer()`
+
+    احصل على دالة عرض مهيأة مسبقًا بواسطة `installIntlayerHTML()`. تُرجع سلسلة HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### أداة `renderHTML()`
+
+    أداة قائمة بذاتها تتجاهل التكوين العام.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## مرجع الخيارات
 
 يمكن تمرير هذه الخيارات إلى `HTMLProvider` و`HTMLRenderer` و`useHTMLRenderer` و`renderHTML`.
 
-| الخيار       | النوع                 | الافتراضي | الوصف                                                                         |
-| :----------- | :-------------------- | :-------- | :---------------------------------------------------------------------------- |
-| `components` | `Record<string, any>` | `{}`      | خريطة تربط علامات HTML أو أسماء المكونات المخصصة بالمكونات.                   |
-| `renderHTML` | `Function`            | `null`    | دالة عرض مخصصة لاستبدال محلل HTML الافتراضي بالكامل (لمزودات Vue/Svelte فقط). |
+| الخيار       | النوع                 | الافتراضي | الوصف                                                                                  |
+| :----------- | :-------------------- | :-------- | :------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`      | خريطة تربط علامات HTML أو أسماء المكونات المخصصة بالمكونات.                            |
+| `renderHTML` | `Function`            | `null`    | دالة عرض مخصصة لاستبدال محلل HTML الافتراضي بالكامل (موفرو Vue وSvelte وRemix وAstro). |
 
 > ملاحظة: بالنسبة لـ React و Preact، يتم توفير علامات HTML القياسية تلقائيًا. تحتاج فقط إلى تمرير الخاصية `components` إذا أردت تجاوزها أو إضافة مكونات مخصصة.