---
x-i18n:
    generated_at: "2026-04-23T07:18:17Z"
    model: gpt-5.4
    provider: openai
    source_hash: 8b046833f9a15dc61894ab9e808a09a9fb055ef7ada5c3d4893fbe5f70dec126
    source_path: AGENTS.md
    workflow: 15
---

# دليل المستندات

يمتلك هذا الدليل مسؤولية تأليف المستندات، وقواعد روابط Mintlify، وسياسة ترجمة المستندات.

## قواعد Mintlify

- تتم استضافة المستندات على Mintlify (`https://docs.openclaw.ai`).
- يجب أن تبقى روابط المستندات الداخلية في `docs/**/*.md` ذات مسارات نسبية من الجذر من دون اللاحقة `.md` أو `.mdx` (مثال: `[Config](/gateway/configuration)`).
- يجب أن تستخدم الإحالات المرجعية بين الأقسام روابط ارتساء على مسارات نسبية من الجذر (مثال: `[Hooks](/gateway/configuration-reference#hooks)`).
- يجب أن تتجنب عناوين المستندات الشرطات الطويلة وعلامات الاقتباس المفردة لأن إنشاء روابط الارتساء في Mintlify غير مستقر معها.
- يجب أن تحتفظ ملفات README وغيرها من المستندات المعروضة على GitHub بعناوين URL المطلقة للمستندات حتى تعمل الروابط خارج Mintlify.
- يجب أن يبقى محتوى المستندات عامًا: من دون أسماء أجهزة شخصية أو أسماء مضيفين أو مسارات محلية؛ استخدم عناصر نائبة مثل `user@gateway-host`.

## قواعد محتوى المستندات

- في المستندات، ونصوص واجهة المستخدم، وقوائم الاختيار، رتّب الخدمات/الموفرين أبجديًا ما لم يكن القسم يصف صراحة ترتيب وقت التشغيل أو ترتيب الاكتشاف التلقائي.
- حافظ على اتساق تسمية Plugin المضمنة مع قواعد مصطلحات Plugin على مستوى المستودع في ملف `AGENTS.md` الجذري.

## ترجمة المستندات

- لا تتم صيانة المستندات بلغات أجنبية في هذا المستودع. توجد مخرجات النشر المُولَّدة في مستودع `openclaw/docs` المنفصل (وغالبًا ما يكون مستنسخًا محليًا باسم `../openclaw-docs`).
- لا تضف أو تعدّل مستندات مترجمة ضمن `docs/<locale>/**` هنا.
- اعتبر المستندات الإنجليزية في هذا المستودع بالإضافة إلى ملفات المسرد المصدرَ المرجعي.
- خط الأنابيب: حدّث المستندات الإنجليزية هنا، وحدّث `docs/.i18n/glossary.<locale>.json` عند الحاجة، ثم اترك مزامنة مستودع النشر وتشغيل `scripts/docs-i18n` في `openclaw/docs`.
- قبل إعادة تشغيل `scripts/docs-i18n`، أضف إدخالات إلى المسرد لأي مصطلحات تقنية جديدة، أو عناوين صفحات، أو تسميات تنقل قصيرة يجب أن تبقى بالإنجليزية أو تستخدم ترجمة ثابتة.
- يُعد `pnpm docs:check-i18n-glossary` وسيلة التحقق من تغيّر عناوين المستندات الإنجليزية والتسميات الداخلية القصيرة للمستندات.
- توجد ذاكرة الترجمة في ملفات `docs/.i18n/*.tm.jsonl` المُولَّدة في مستودع النشر.
- راجع `docs/.i18n/README.md`.
