# مقدمة

Onedocs مجموعة من التخطيطات والمكونات والمساعدات لمواقع التوثيق المبنية باستخدام Next.js وFumadocs. تكتب Markdown، وتصف موقعك في ملف إعداد واحد، ويوفّر Onedocs هيكل التوثيق وصفحة رئيسية ومسارات SEO.

صُمّم لمواقع التوثيق المستقلة، وليس لإضافة التوثيق إلى تطبيق قائم.

## ما الذي يضيفه Onedocs

إضافةً إلى Fumadocs، تمنحك حزمة `onedocs` ما يلي:

- **التخطيطات** - يحيط `DocsLayout` و`DocsPage` بتخطيط توثيق UI من Fumadocs، مع شريط جانبي وبحث ومبدّل للسمة وجدول محتويات. ويعرض `HomePage` صفحة هبوط تضم عنوانًا رئيسيًا وأوامر التثبيت والميزات والتذييل.
- **ملف إعداد واحد** - يحتوي `onedocs.config.ts` على العنوان والوصف والشعار والأيقونة المفضلة وروابط التنقل والتذييل ومحتوى الصفحة الرئيسية.
- **مكونات MDX** - يسجّل `mdxComponents` مربعات التنبيه وعلامات التبويب والبطاقات والخطوات والأقسام القابلة للطي وأشجار الملفات وتكبير الصور وجداول الأنواع، لتستخدمها الصفحات دون استيراد.
- **إعداد مسبق لـCSS** - يستورد واحد يجلب Tailwind CSS v4 وسمة UI في Fumadocs وأنماط تخطيط Onedocs.
- **مساعدات SEO** - دوال لـ`sitemap.xml` و`robots.txt` و`llms.txt` وllms-`llms-full.txt` وبيانات الصفحة الوصفية وصور Open Graph.

## ما تحتاج إلى إعداده بنفسك

لا يضمّن Onedocs Next.js أو Fumadocs. فهما اعتمادان نظيران تثبّتهما إلى جانبه:

```bash
npm install onedocs fumadocs-core fumadocs-mdx fumadocs-ui lucide-react@0.562 next react react-dom
```

تحتاج أيضًا إلى Tailwind CSS v4 وNode.js 20.9 أو أحدث ونحو عشرة ملفات صغيرة: إعداد Next.js وFumadocs MDX ومصدر المحتوى والتخطيط الجذري وتخطيط التوثيق ومسار صفحة التوثيق. يعرض [دليل البدء](https://onedocs.inline0.dev/ar/docs/getting-started) كل ملف منها.

## مواضع الإعداد

| العنصر | الموضع |
|------|-------|
| عنوان الموقع والشعار والتنقل والتذييل | `onedocs.config.ts`، راجع [الإعداد](https://onedocs.inline0.dev/ar/docs/configuration) |
| العنوان الرئيسي والميزات في الصفحة الرئيسية | `homepage` في `onedocs.config.ts`، ويعرضه `HomePage` في `src/app/page.tsx` |
| تخطيط التوثيق وصفحاته | `src/app/docs/layout.tsx` و`src/app/docs/[[...slug]]/page.tsx`، راجع [دليل البدء](https://onedocs.inline0.dev/ar/docs/getting-started) |
| مجلد المحتوى وترتيب الشريط الجانبي | `source.config.ts` و`content/docs/meta.json` |
| مكونات MDX | `mdxComponents`، راجع [المكونات](https://onedocs.inline0.dev/ar/docs/components) |
| البحث وخريطة الموقع وrobots.txt وllms.txt | ملفات المسارات ضمن `src/app/`، راجع [SEO والبحث](https://onedocs.inline0.dev/ar/docs/seo-search) |
| البيانات الوصفية وصور Open Graph | `onedocs/metadata` و`onedocs/og`، راجع [مرجع API](https://onedocs.inline0.dev/ar/docs/api-reference) |

## الفلسفة

- **Markdown أولًا** - اكتب `.md` أو `.mdx` لتحصل على التوثيق
- **ملف إعداد واحد** - توجد إعدادات الموقع العامة في `onedocs.config.ts`
- **خيارات تحكم إضافية** - لمزيد من التحكم، استخدم Fumadocs مباشرةً

## ابدأ من هنا

- [دليل البدء](https://onedocs.inline0.dev/ar/docs/getting-started)
- [المكونات](https://onedocs.inline0.dev/ar/docs/components)
- [SEO والبحث](https://onedocs.inline0.dev/ar/docs/seo-search)
- [الإعداد](https://onedocs.inline0.dev/ar/docs/configuration)
- [مرجع API](https://onedocs.inline0.dev/ar/docs/api-reference)