نصب و راه اندازی جنگو
نکته اگر از Chromebook استفاده میکنید، این فصل را رد کنید و مطمئن شوید که دستورالعمل تنظیمات Chromebook را دنبال کنید.
نکته اگر مراحل نصب و راهاندازی را انجام دادهاید یعنی این بخش انجام شده است، میتوانید مستقیم به بخش بعد بروید!
قسمتهایی از این بخش بر اساس دوره آموزشی Geek Girls Carrots است (https://github.com/ggcarrots/django-carrots).
قسمتهایی نیز بر پايه دوره آموزشی django-marcador tutorial و با مجوز Creative Commons Attribution-ShareAlike 4.0 International License است. حقوق دوره آموزشی django-marcador متعلق به Markus Zapke-Gründemann و همکاران میباشد.
محیط مجازی
قبل از اینکه ما جنگو را نصب کنیم، ابزاری بسیار پراستفاده به شما میدهیم تا با نصب آن محیط برنامه نویسی خود را بر روی کامپیوترتان تمیز و مرتب نگه دارید. میتوانید برای ادامه کار از این مرحله صرف نظر کنید اما استفاده از آن بسیار توصیه میشود. شروع کار با تنظیمات مناسب جلوی بسیاری از مشکلات در آینده را میگیرد!
بنابراین، اجازه دهید یک محیط مجازی یا virtual environment بسازیم (همچنین به آن virtualenv هم گفته میشود). محیط مجازی، تنظیمات پایتون/جنگو را برای هر پروژه و جدا از دیگر پروژهها، قرنطینه و حفظ خواهد کرد. یعنی هر تغییری که در تنظیمات یک وبسایت انجام میدهید، بر روی دیگر وبسایتهایی که در حال توسعه آنها هستید تاثیر نخواهد گذاشت. تمیز و مرتب، اینطور نیست؟
آنچه شما باید انجام دهید این است که یک پوشه را پیدا کنید که در آن میخواهید محیط مجازی
را ایجاد کنید. برای مثال، پوشه home. در ویندوز، چیزی شبیه C:\Users\Name
است (که در آن Name
نام کاربری شما است که با آن وارد ویندوز شدهاید).
نکته: در ویندوز اطمینان حاصل کنید که نام این پوشه حاوی کاراکترهای خاص یا دارای اعراب نیست؛ اگر نام کاربری شما دارای کاراکترهای خاص است، از یک پوشه دیگر استفاده کنید، به عنوان مثال
C:\djangogirls
.
برای این آموزش ما از یک پوشه جدید djangogirls
در پوشه اصلی شما استفاده خواهیم کرد:
خط فرمان
$ mkdir djangogirls
$ cd djangogirls
ما یک محیط مجازی به نام myvenv
خواهیم ساخت. فرمان کلی در این قالب خواهد بود:
خط فرمان
$ python3 -m venv myvenv
برای ایجاد یک محیط مجازی
جدید، باید کنسول خط فرمان را باز کنید و دستور <python -m venv myvenv
را اجرا کنید. شبیه این خواهد شد:
خط فرمان
C:\Users\Name\djangogirls> python -m venv myvenv
در اینجا myvenv
نام محیط مجازی
شماست. میتوانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس، اعراب گذاری و کاراکترهای خاص استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!
میتوانیم با دستور python3 -m venv myvenv
هم در لینوکس و هم در macOS محیط مجازی
بسازیم. شبیه این خواهد بود:
خط فرمان
$ python3 -m venv myvenv
نام محیط مجازی
شما، myvenv
است. میتوانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!
نکته: در بعضی نسخههای دبیان/اوبونتو ممکن است چنین پیغام خطایی دریافت کنید:
خط فرمان
The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command. apt install python3-venv You may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.
در این موارد دستورالعمل داده شده در بالا را دنبال کنید. پکیج
python3-venv
را نصب کنید:خط فرمان
$ sudo apt install python3-venv
نکته: در بعضی نسخههای دبیان/اوبونتو ساختن محیط مجازی با این دستور ممکن است باعث چنین خطایی بشود:
خط فرمان
Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
برای حل این مشکل، از دستور
virtualenv
استفاده کنید.خط فرمان
$ sudo apt install python-virtualenv $ virtualenv --python=python3.12 myvenv
نکته: اگر چنین خطایی گرفتید
خط فرمان
E: Unable to locate package python3-venv
در عوض از این دستور استفاده کنید:
خط فرمان
sudo apt install python3.12-venv
کار کردن با محیط مجازی
دستور بالا یک پوشه به نام myvenv
میسازد (یا هر نام دیگری که شما گذاشته باشید) که شامل محیط مجازی ماست (درواقع مجموعهای از پوشهها و فایلها).
محیط مجازی خود را با اجرای دستور زیر فعال کنید:
خط فرمان
C:\Users\Name\djangogirls> myvenv\Scripts\activate
نکته: در ویندوز 10 و در هنگام استفاده از Windows PowerShell ممکن است با این خطا مواجه شوید
execution of scripts is disabled on this system
. در این شرایط یک بار دیگر Windows PowerShell را با گزینه "Run as Administrator" اجرا کنید. سپس دستورات زیر را قبل از فعال کردن محیط مجازی خود، اجرا کنید:خط فرمان
C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned Execution Policy Change The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
نکته: برای کاربران ویرایشگر VS Code که درون خود یک ترمینال خط فرمان منطبق بر PowerShell ویندوز دارد، اگر بخواهید از این ترمینال استفاده کنید باید این دستور را برای فعال کردن محیط مجازی خود بزنید:
$ . myvenv\Scripts\activate.ps1
مزیت آن این است که لازم نیست بین پنجره ویرایشگر کد و پنجره خط فرمان جابجا شوید
محیط مجازی خود را با اجرای دستور زیر فعال کنید:
خط فرمان
$ source myvenv/bin/activate
به یاد داشته باشید که myvenv
را با نامی که برای محیط مجازی
خود انتخاب کردهاید عوض کنید!
نکته: گاهی اوقات ممکن است دستور
source
در دسترس نباشد. در این مواقع دستور زیر را امتحان کنید:خط فرمان
$ . myvenv/bin/activate
هنگامی که پیشوند (myvenv)
در کنسول خط فرمان اضافه شود به معنی آن است که محیط مجازی
شما فعال شده است.
وقتی درون یک محیط مجازی کار میکنید کلمه python
به صورت اتوماتیک به نسخه صحیح پایتون ارجاع میدهد در نتیجه میتوانید به جای python3
از python
استفاده کنید.
بسیار خوب، ما همه نیازمندیها را داریم حالا میتوانیم جنگو را نصب کنیم!
نصب جنگو
حالا که محیط مجازی
شما فعال شده است میتوانید جنگو را نصب کنید.
قبل از آن باید مطمئن شویم که آخرین نسخه pip
که برای نصب جنگو استفاده میشود را داریم:
خط فرمان
(myvenv) ~$ python -m pip install --upgrade pip
نصب پکیجها و پیشنیازهایشان
یک فایل پیشنیازها شامل لیستی از پکیجهای وابسته است که باید به کمک pip install
نصب شوند:
در ابتدا یک فایل requirements.txt
در پوشه djangogirls/
بسازید. معمولاً میتوانید از خود ویرایشگر کد که قبلتر نصب کردهاید هم برای ساختن فایل جدید استفاده کنید. یک فایل جدید در ویرایشگر کد بسازید و سپس به نام requirements.txt
در پوشه djangogirls/
ذخیرهاش کنید. پوشه شما شبیه این خواهد بود:
djangogirls
├── myvenv
│ └── ...
└───requirements.txt
در فایل djangogirls/requirements.txt
باید خط زیر را اضافه کنید:
djangogirls/requirements.txt
Django~=5.1.2
حالا دستور pip install -r requirements.txt
را اجرا کنید تا جنگو نصب شود.
خط فرمان
(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=5.1.2 (from -r requirements.txt (line 1))
Downloading Django-5.1.2-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-5.1.2
اگر در هنگام اجرای دستور pip در ویندوز خطایی دریافت کردید لطفاً کنترل کنید که در مسیر نام پوشهها هیچ پوشهای اسپیس، اعراب گذاری یا کارکتر خاص در نام خود نداشته باشد (مثلا مانند این
C:\Users\User Name\djangogirls
). اگر چنین است لطفاً از مسیری استفاده کنید که در آن اسپیس به کار نرفته باشد (مثلا چنین مسیریC:\djangogirls
). یک محیط مجازی در پوشه جدید درست کنید سپس محیط مجازی قبلی را پاک کنید و دستور بالا را دوباره اجرا کنید. (جابجا کردن پوشه مربوط به محیط مجازی ایده خوبی نیست و باعث میشود محیط مجازی کار نکند. محیط مجازی با آدرس مطلق کار میکند)
عالی! بالاخره در نهایت آماده شدید تا یک برنامه جنگو بسازید!