---
x-i18n:
    generated_at: "2026-04-12T23:27:51Z"
    model: gpt-5.4
    provider: openai
    source_hash: 6805814012caac6ff64f17f44f393975510c5af3421fae9651ed9033e5861784
    source_path: AGENTS.md
    workflow: 15
---

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

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

## قواعد Mintlify

- تتم استضافة المستندات على Mintlify (`https://docs.openclaw.ai`).
- يجب أن تبقى روابط المستندات الداخلية في `docs/**/*.md` نسبية إلى الجذر ومن دون اللاحقة `.md` أو `.mdx` (مثال: `[Config](/configuration)`).
- يجب أن تستخدم الإشارات المرجعية بين الأقسام مراسي على مسارات نسبية إلى الجذر (مثال: `[Hooks](/configuration#hooks)`).
- يجب أن تتجنب عناوين المستندات الشرطات الطويلة والفواصل العليا لأن إنشاء المراسي في Mintlify غير مستقر معها.
- يجب أن تحتفظ ملفات README وغيرها من المستندات المعروضة على GitHub بروابط المستندات المطلقة حتى تعمل الروابط خارج 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`.
