البدء

يساعدك هذا الدليل على بدء استخدام Xingluo للتطوير المحلي وبنيات الإنتاج من الصفر.

المتطلبات

التبعية	الحد الأدنى للإصدار	ملاحظات
Node.js	22.12.0	انظر `engines.node` في `package.json`
pnpm	10.x	مدير الحزم (يستخدم المشروع pnpm workspace)

نصيحة: إدارة إصدارات Node باستخدام fnm أو nvm.

بعد استنساخ المستودع، قم بتثبيت التبعيات:

bash
pnpm install

بمجرد تثبيت التبعيات، يتم استبعاد المشاريع المرجعية تحت references/ تلقائيًا من تجميع TypeScript والبناء (انظر exclude في tsconfig.json).

ابدأ خادم التطوير (الافتراضي http://localhost:4321/):

bash
pnpm dev

في وضع التطوير:

المسودات والمقالات المجدولة كلها مرئية (للمعاينة)؛ يتم تصفيتها فقط أثناء بناءات الإنتاج
تغييرات مجموعة المحتوى تؤدي إلى إعادة تحميل فوري
سلوكيات جانب العميل (تبديل السمة، View Transitions، إلخ.) تطابق الإنتاج

بعد تعديل مخططات أو أنواع مجموعات المحتوى، قم بتشغيل المزامنة لتحديث .astro/types.d.ts:

bash
pnpm sync

يتكون بناء الإنتاج من ثلاث خطوات (انظر البرنامج النصي build في package.json):

bash
pnpm build

astro check: فحص أنواع TypeScript وقوالب Astro؛ أي خطأ يوقف البناء
astro build: يُنشئ الموقع بأكمله بشكل ثابت في dist/ (بما في ذلك صور OG الديناميكية، RSS، خريطة الموقع، robots.txt)
node scripts/generateSearchIndex.mjs: يمسح dist/ لإنشاء فهرس البحث للنص الكامل في dist/search/

ملاحظة: يتم إنشاء فهرس البحث بواسطة سكريبت Node بعد البناء.

معاينة مخرجات البناء في dist/ محليًا:

bash
pnpm preview

الأمر	الغرض
`pnpm format`	تنسيق جميع الكود باستخدام Prettier (بما في ذلك Astro و Tailwind)
`pnpm format:check`	التحقق من الامتثال للتنسيق (يستخدم في CI)
`pnpm lint`	فحوصات ESLint (بما في ذلك `eslint-plugin-astro`)