البدء

مرحبًا بك في mineproj! سيساعدك هذا الدليل في إنشاء أول موقع محفظة مشاريع لك.

المتطلبات الأساسية

• Node.js 22 أو أحدث
• pnpm 10 (قم بالتثبيت عبر npm install -g pnpm)

إنشاء موقع جديد

أسرع طريقة للبدء هي باستخدام أداة السقالات:

npx create-mineproj my-portfolio
cd my-portfolio
pnpm dev

افتح http://localhost:5173 في متصفحك لمشاهدة موقعك.

هيكل المشروع

my-portfolio/
├─ mineproj.config.ts      # إعدادات الموقع
├─ data/
│  ├─ projects/             # بيانات المشاريع (JSON + Markdown)
│  │  └─ my-project/
│  │     ├─ index.json      # بيانات وصفية للمشروع
│  │     └─ body.md         # محتوى المشروع
│  ├─ profile.json          # ملفك الشخصي
│  └─ tags.json             # تعريفات الوسوم
├─ public/                  # الأصول الثابتة (صور، PDF، إلخ)
└─ dist/                    # مخرجات البناء (مولدة)

إضافة مشروع

أنشئ دليلًا جديدًا تحت data/projects/:

mineproj new my-project

سيؤدي هذا إلى إنشاء data/projects/my-project/index.json و data/projects/my-project/body.md. قم بتعديل ملف JSON لتعيين البيانات الوصفية للمشروع.

البناء للإنتاج

pnpm build

المخرجات تذهب إلى dist/. يمكنك معاينتها محليًا:

pnpm preview

الخطوات التالية

• دليل الإعدادات — مرجع كامل للإعدادات
• نموذج البيانات — فهم مخطط المشروع
• تطوير السمة — تخصيص المظهر والشعور
• تطوير الإضافة — توسيع الوظائف
• النشر — نشر موقعك إلى الإنتاج