التوثيق

كيف بُني هذا التوثيق وكيف تضيف صفحة.

يتبع التوثيق إعداد hogwarts نفسه، الذي يحاكي ui.shadcn.com/docs: محتوى MDX يترجمه fumadocs-mdx، وتلوين الكود وقت البناء بـ rehype-pretty-code، مع شريط جانبي وفهرس للصفحة وقائمة "نسخ الصفحة".

أضف صفحة

اكتب الصفحة الإنجليزية

أنشئ content/docs-en/<slug>.mdx مع title وdescription في الترويسة.

content/docs-en/example.mdx

---
title: Example
description: One sentence about the page.
---
 
## First section

اكتب الصفحة العربية

أنشئ content/docs-ar/<slug>.mdx بالمعرّف نفسه.

أضفها إلى الشريط الجانبي

أضف المعرّف إلى ملفي meta.json. العنصر "---Label---" يبدأ مجموعة معنونة.

أضفها إلى قائمة الهاتف

أضف الرابط إلى src/components/docs/docs-config.ts وعنوانه إلى docs.sidebar في القاموسين.

المكوّنات

المكوّن	الاستخدام
`<Callout>`	ملاحظة بارزة
`<CardGrid>` `<DocCard>`	بطاقات مرتبطة
`<Steps>`	خطوات مرقّمة من عناوين `###`
`<Tabs>`	محتوى بتبويبات
`<Accordion>`	أقسام قابلة للطي

الملفات

الملف	الدور
`source.config.ts`	المجموعات ومسار معالجة MDX
`src/lib/source.ts`	محمّل fumadocs لكل لغة
`src/mdx-components.tsx`	تنسيق النصوص ومكوّنات التوثيق
`src/app/[lang]/(site)/docs/`	مسارات التخطيط والصفحة
`src/components/docs/`	الشريط الجانبي، والفهرس، ونسخ الصفحة، والتنبيهات

النشر

في هذه الصفحة

أضف صفحة اكتب الصفحة الإنجليزية اكتب الصفحة العربية أضفها إلى الشريط الجانبي أضفها إلى قائمة الهاتف المكوّنات الملفات