- [ الرئيسية ](/ar/) / - [ كيفية إنشاء llms.txt ](/ar/how-to-create/) / - MkDocs # `llms.txt` في MkDocs ينسخ MkDocs كل ملف من docs/ إلى جذر الموقع، لذلك يكفي وضع llms.txt هناك وإبعاده عن قائمة التنقل. آخر تحديث: 26 يوليو 2026 في هذه الصفحة - [ إلى أين يذهب الملف ](#overview) - [ الطريقة: دليل docs/ ](#docs) - [ أبقِه خارج التنقل ](#nav) - [ التحقق من الإعداد ](#verify) ## إلى أين يذهب الملف ينشئ MkDocs `docs_dir` (افتراضياً `docs/`) في `site/` مجلد. وتصبح ملفات Markdown صفحات HTML؛ وكل ملف آخر، بما فيه `.txt`، ويُنسخ إلى المسار المطابق في `site/`. لذلك `docs/llms.txt` يُقدَّم على العنوان `/llms.txt`. تعامل مع الملف كخريطة منتقاة لمجموعة التوثيق. أدرج أدلة التثبيت ومرجع الإعداد وصفحات API وملاحظات الترقية وسجل التغييرات، لكن تجنب إغراق الملف بكل صفحة منشأة. والقائمة الأصغر التي تتم صيانتها أسهل تدقيقاً للمساعدات والبشر. ## الطريقة: دليل docs/ - أضف الملف: `touch docs/llms.txt` - ارسم خريطة لصفحات التوثيق الأساسية لديك (فالوثائق هي بالضبط ما تريده المساعدات هنا): ``` # Your Project Docs > Documentation for Your Project: installation, usage, and API reference. ## Guides - [Installation](https://yourdomain.com/install/): setup and requirements. - [User guide](https://yourdomain.com/guide/): day-to-day usage. ## Reference - [API](https://yourdomain.com/api/): full reference. ``` - ابنِ وانشر: `mkdocs build` (أو `mkdocs gh-deploy` لـ GitHub Pages). ## أبقِه خارج شريط التنقّل مثال not_in_nav حتى لا يظهر الملف كإدخال تنقل وهمي، أدرجه تحت not_in_nav في mkdocs.yml : ``` not_in_nav: | /llms.txt ``` يفيد هذا أيضاً إذا كنت تستخدم validation.nav.omitted_files: warn , الذي كان سيضع علامة على الملف لولا ذلك. ## التحقق من الإعداد ``` curl -sI https://yourdomain.com/llms.txt | grep -i content-type # expect: content-type: text/plain ``` هل تنشر توثيقاً إلى GitHub Pages؟ انتبه إلى تحفظ المسار الأساسي في [دليل GitHub Pages](/ar/llms-txt-github-pages/). ويُغطّى إنشاء محتوى الملف في [دليل إجرائي](/ar/how-to-create/)؛ تحقّق منه باستخدام [المدقّق](/ar/validator/). ## المصادر - [ توثيق MkDocs، الإعداد (not_in_nav) ](https://www.mkdocs.org/user-guide/configuration/#not_in_nav) - [ llmstxt.org، مرجع المواصفة ](https://llmstxt.org/)