QUICKSTART.md

راهنمای نصب سریع

این راهنما به شما کمک می‌کند تا پروژه وب‌سایت انجمن علمی را به سرعت راه‌اندازی کنید.

مراحل نصب سریع

1. پیش‌نیازها:

   • پایتون 3.8+
   • pip
   • git

2. کلون کردن مخزن:

   git clone [آدرس مخزن]
   cd [نام پوشه پروژه]

3. نصب و راه‌اندازی:

   # ایجاد محیط مجازی
   python -m venv venv
   
   # فعال‌سازی محیط مجازی (ویندوز)
   venv\Scripts\activate
   
   # فعال‌سازی محیط مجازی (لینوکس/مک)
   # source venv/bin/activate
   
   # نصب وابستگی‌ها
   pip install -r requirements.txt
   
   # اجرای مهاجرت‌ها
   python manage.py migrate
   
   # ایجاد کاربر ادمین
   python manage.py createsuperuser
   
   # اجرای سرور توسعه
   python manage.py runserver

4. دسترسی به وب‌سایت:

   • آدرس صفحه اصلی: http://127.0.0.1:8000/
   • آدرس پنل مدیریت: http://127.0.0.1:8000/admin/

عیب‌یابی مشکلات رایج

1. خطای وابستگی‌های نصب نشده:

   pip install --upgrade pip
   pip install -r requirements.txt

2. خطای مهاجرت دیتابیس:

   python manage.py makemigrations
   python manage.py migrate

3. خطای فایل‌های استاتیک:

   python manage.py collectstatic

4. مشکل تصاویر:

   • اطمینان حاصل کنید که پوشه media وجود دارد
   • مطمئن شوید که Pillow نصب شده است

5. مشکل تاریخ شمسی:

   • اطمینان حاصل کنید که jdatetime نصب شده است

منابع مفید

• مستندات جنگو
• آموزش جنگو
• فایل README.md برای اطلاعات بیشتر