مقدمة الدليل التعليمي

لنكتشف Docusaurus في أقل من 5 دقائق.

البدء

ابدأ عن طريق إنشاء موقع جديد.

أو جرّب Docusaurus فورًا عبر docusaurus.new.

ما ستحتاج إليه

• Node.js الإصدار 18.0 أو أعلى:
  • عند تثبيت Node.js، يُوصى بتحديد جميع مربعات الاختيار المتعلقة بالتبعيات.

توليد موقع جديد

قم بتوليد موقع Docusaurus جديد باستخدام القالب الكلاسيكي.

سيُضاف القالب الكلاسيكي تلقائيًا إلى مشروعك بعد تشغيل الأمر:

npm init docusaurus@latest my-website classic

يمكنك كتابة هذا الأمر في موجه الأوامر أو Powershell أو Terminal أو أي طرفية مدمجة أخرى في محرر الشيفرة لديك.

يقوم الأمر أيضًا بتثبيت جميع التبعيات الضرورية التي تحتاجها لتشغيل Docusaurus.

بدء تشغيل موقعك

شغّل خادم التطوير:

cd my-website
npm run start

يغيّر الأمر cd الدليل الذي تعمل به. للعمل مع موقع Docusaurus الذي أنشأته حديثًا، ستحتاج إلى الانتقال بالطرفية إلى هناك.

يقوم الأمر npm run start ببناء موقعك محليًا ويقدّمه عبر خادم تطوير، جاهزًا لك لعرضه على http://localhost:3000/.

افتح docs/intro.md (هذه الصفحة) وعدّل بعض الأسطر: يقوم الموقع بإعادة التحميل تلقائيًا ويعرض تغييراتك.