شغّل الموقع بدون Docker
ثبّت الموقع وشغّله باستخدام Node.js و Yarn، في وضع التطوير أو كبناء إنتاج.
قبل أن تبدأ: ثبّت Node.js 20.9 أو أحدث، ويُنصح بالإصدار 22 أو 24. لا تحتاج إلى قاعدة بيانات ولا إلى ملف .env في أول تشغيل.
نزّل القالب وفك ضغطه كما في دليل Docker، ثم افتح طرفية داخل المجلد Publino-template.
شغّل خادم التطوير
فعّل Corepack
يشغّل Corepack إصدار Yarn الذي يثبّته المشروع، وهو Yarn 4.6.0. تحتاج إلى ذلك مرة واحدة فقط على كل جهاز.
الطرفيةcorepack enableتواجه مشكلة؟ثبّت الاعتماديات
الطرفيةفيPublino-templateyarn installالنتيجة المتوقعة: ينتهي Yarn بالكلمة
تواجه مشكلة؟Doneويظهر مجلدnode_modules.شغّله وافتح الموقع
الطرفيةفيPublino-templateyarn devالمنفذ مستخدم بالفعل؟
إذا توقف التشغيل برسالة
المنفذ مستخدم بالفعلEADDRINUSE: address already in use :::3030، فبرنامج آخر يستخدم المنفذ 3030. أوقفه، أو شغّل الموقع على منفذ آخر بالأمرyarn dev -p 3041وافتح localhost:3041محلي.النتيجة المتوقعة: يفتح localhost:3030محلي الصفحة الرئيسية. وتُحدَّث تلقائيًا عند حفظ أي ملف.
تواجه مشكلة؟
أوقف الخادم بالضغط على Ctrl+C في طرفيته.
شغّل بناء الإنتاج
خادم التطوير مخصص للتعديل. لتفحص الموقع كما يراه الزوار، ابنِه مرة واحدة، ثم قدّم البناء:
Publino-templateyarn build
yarn startيعمل أيضًا على localhost:3030محلي. إذا كان المنفذ 3030 مشغولًا، فاستخدم yarn start -p 3041. شغّل yarn build من جديد بعد كل تغيير، فالأمر yarn start يعرض آخر بناء كما هو.
السكربتات
| السكربت | وظيفته |
|---|---|
yarn dev | خادم التطوير على المنفذ 3030 |
yarn build | بناء الإنتاج |
yarn start | يقدّم بناء الإنتاج على المنفذ 3030 |
yarn lint | يفحص الكود باستخدام ESLint وقواعد Next.js |
yarn typecheck | يتحقق من أنواع TypeScript |
إعداداتك الخاصة
كل إعداد اختياري. لتغيير أحدها، انسخ .env.example إلى .env.local وعدّله هناك. تُقرأ القيم عند تشغيل التطبيق في وضع التطوير وعند البناء، لذا أعد تشغيل yarn dev أو شغّل yarn build من جديد بعد أي تغيير.
Publino-templatecp .env.example .env.local