اگر این آموزش را در خانه دنبال میکنید
اگر این آموزش را در خانه دنبال میکنید و نه در یکی از رویدادهای دختران جنگو، میتوانید به طور کامل از این بخش بگذرید و به بخش اینترنت چگونه کار می‌کند بروید.
به دلیل اینکه ما نصب کردن هر چیزی را که دراین سری آموزشی نیاز است، در محل مورد نیاز بیان می‌کنیم. این صفحه تنها برای بیان همه دستورات نصب در یک مکان، اضافه شده است (که برای برخی کارگاه‌ها مفید است). شما میتوانید هرچیزی که در این بخش آمده است را نصب کنید. اما اگر ترجیح می‌دهید پیش از نصب چند ابزار و نرم افزار روی کامپیوترتان، در مورد آنها یاد بگیرید، از این بخش عبور کنید. ما نحوه‌ی نصب هر چیزی را، زمانی که به آن نیاز داشتید، توضیح می‌دهیم.
موفق باشید!
اگر در یک کارگاه شرکت کرده‌اید
اگر در یکی از رویدادهای جنگو برای دختران شرکت کرده اید:
- ممکن است کارگاه شما یک "جلسه نصب پیش‌نیازها" قبل از رویداد اصلی داشته باشد. اگر در جلسه نصب پیش‌نیازها هستید، این بخش مخصوص شماست! برای نصب هرچیزی که در این رویداد نیاز دارید، دستورالعمل‌های این بخش را دنبال کنید، و در صورت نیاز از مربی‌ها کمک بگیرید. سپس در کارگاه اصلی، میتوانید از دستورالعمل‌های نصب که در آموزش اصلی با آنها مواجه می‌شوید، عبور کنید.
- ممکن است برگزار کنندگان کارگاه، از شما بخواهند تا سعی کنید همه چیز را قبل از شروع کارگاه روی کامپیوترتان نصب کنید. اگر از شما این درخواست را داشته اند، این بخش برای شماست! به بهترین نحو دستورالعمل های این بخش را دنبال کنید. اگر نتوانستید چیزی را نصب کنید، در کارگاه اصلی، زمانی که به دستورالعمل‌های نصب آن بخش در آموزش اصلی می‌رسید، میتوانید از مربی‌ها کمک بگیرید.
- اگر کارگاه شما فاقد جلسه نصب پیش نیازها بود (یا شما نتوانستید در آن شرکت کنید)، و اگر برگزارکنندگان از شما نخواستند که همه چیز را پیش از شروع رویداد نصب کنید، از این بخش عبور کنید و مستقیم به بخش اینترنت چگونه کار می‌کند بروید. شما هر چیزی را که به آن نیاز دارید، در طول آموزش اصلی نصب خواهید کرد.
نصب پیش‌نیازها
در این آموزش شما یک وبلاگ خواهید ساخت. برای انجام این کار، در خلال روند آموزش، به شما نحوه‌ی نصب نرم‌افزارهای مختلف روی کامپیوترتان و نحوه‌ی راه اندازی چند حساب اینترنتی گفته خواهد شد. این بخش شامل تمام مراحل نصب و دستورالعمل‌های ثبت نام است (که برای بعضی از کارگاه‌ها مفید است).
اگر از Chromebook استفاده نمی‌کنید میتوانید از این بخش عبور کنید. اگر از آن استفاده میکنید تجربه نصب شما کمی متفاوت خواهد بود. شما می توانید بقیه دستورالعمل نصب را نادیده بگیرید.
IDE ابری (PaizaCloud Cloud IDE, AWS Cloud9)
IDE ابری ابزاری است که به شما دسترسی به یک ویرایشگر کد و یک کامپیوتر در حال کار کردن روی اینترنت را می‌دهد که میتوانید نصب، نوشتن و اجرای برنامه‌ها را در آن انجام دهید. در زمان این آموزش، IDE ابری به عنوان دستگاه محلی شما عمل خواهد کرد. شما همچنان مانند سایر همکلاسی‌ها که از OS X، اوبونتو یا ویندوز استفاده می‌کنند، دستورات را در ترمینال اجرا خواهید کرد اما ترمینال شما به کامپیوتری که IDE ابری برای شما آماده کرده متصل است. در اینحا دستورالعمل استفاده از IDE های ابری (PaizaCloud Cloud IDE و AWS Cloud9) را خواهید دید. شما میتوانید یکی از IDE های ابری را انتخاب کنید و دستورالعمل را دنبال کنید.
IDE ابری PiazaCloud
- به PaizaCloud Cloud IDE بروید
- یک حساب کاربری بسازید
- بر روی New Server کلیک کنید و گزینه Django app را انتخاب کنید
- دکمه Terminal را (در سمت چپ صفحه) بزنید
حالا شما باید صفحه ای با یک ستون کناری و کلیدهایی در سمت چپ ببینید. بر روی دکمه "Terminal" کلیک کنید تا پنجره ترمینال با پیغامی شبیه به این باز شود:
Terminal
$
ترمینال در IDE ابری PiazaCloud برای دستورات شما آماده شده است. شما میتوانید اندازه این پنجره را تغییر دهید تا کمی بزرگتر دیده شود.
AWS Cloud9
در حال حاضر برای استفاده از Cloud 9 باید با اکانت AWS ثبت نام کنید و مشخصات کارت اعتباری را نیز وارد کنید.
- Cloud 9 را از Chrome web store نصب کنید
- به c9.io بروید و بر روی Get started with AWS Cloud9 کلیک کنید
- با یک حساب AWS ثبت نام کنید (به اطلاعات کارت اعتباری نیاز است اما میتوانید به رایگان از آن استفاده کنید)
- در داشبورد AWS عبارت Cloud9 را در محل جستجو وارد کنید و کلید جستجو را بزنید
- در داشبورد Cloud 9 بر روی Create environment کلیک کنید
- نام آن را django-girls بگذارید
- در هنگام انجام تنظیمات، در بخش "Environment Type" گزینه Create a new instance for environment (EC2) را و در بخش "Instance type" گزینه t2.micro را انتخاب کنید ("Free-tier eligible" را نشان خواهد داد). تنظیمات پیشفرض صرفه جویانه و خوب است و شما هم باقی تنظیمات پیشفرض را نگه دارید.
- بر روی Next step کلیک کنید
- بر روی Create environment کلیک کنید
حالا باید صفحه‌ای با یک نوار کناری، یک صفحه اصلی بزرگ با مقداری نوشته و یک صفحه کوچک در پایین ببینید که شبیه به این خواهد بود:
bash
yourusername:~/workspace $
این محدوده پایین، ترمینال شماست. شما میتوانید از این ترمینال برای فرستادن دستورات به کامپیوتر Cloud 9 استفاده کنید. میتوانید ابعاد این پنجره را تغییر دهید تا کمی بزرگتر دیده شود.
محیط مجازی
یک محیط مجازی (که به آن virtualenv هم گفته می‌شود) شبیه به یک جعبه مجازی است که ما می‌توانیم کدهای مربوط به یک پروژه را در آن جمع کنیم. ما از آنها برای جدا نگه داشتن کدهای پروژه‌های مختلف از یکدیگر، استفاده می‌کنیم تا به هم ریختگی بین پروژه‌ها به وجود نیاید.
بعد، دستور زیر را اجرا کنید:
Cloud 9
mkdir djangogirls
cd djangogirls
python3.6 -mvenv myvenv
source myvenv/bin/activate
pip install django~=2.2.4
(دقت کنید که ما در خط آخر از یک علامت tilde به همراه یک علامت مساوی استفاده کرده‌ایم: ~=).
GitHub
یک حساب کاربری GitHub بسازید.
PythonAnywhere
دوره آموزشی جنگوگرلز شامل بخشی است به نام فاز دیپلوی یا Deployment، که شامل گرفتن و انتقال دادن کدهای وبسایت شما به یک کامپیوتر در دسترس عموم (به نام سرور) است تا سایرین هم بتوانند کار شما را ببینند.
اگر این دوره آموزشی را بر روی Chromebook که خودش کامپیوتری بر روی اینترنت است (در مقابل لپ تاپ‌های معمولی که کامپیوتری محلی محسوب می‌شوند)، انجام می‌دهید این بخش کمی عجیب خواهد بود. با اینحال همچنان می‌تواند مفید باشد، به این صورت که ما فضای Cloud 9 را فضای کار "in progress" یا در جریان، و PythonAnywhere را محلی برای نمایش کارهای کامل شده درنظر خواهیم گرفت.
بنابراین یک حساب کاربری جدید در www.pythonanywhere.com بسازید.
معرفی کوتاه کنسول خط فرمان
بسیاری از مراحل زیر به "کنسول"، "ترمینال"، "پنجره دستورات" یا "خط فرمان" اشاره می‌کنند ـ همه آنها یک معنا دارند: یک پنجره روی کامپیوتر شما که میتوانید دستوراتی را در آن وارد کنید. زمانی که به آموزش اصلی رسیدید، در مورد خط فرمان بیشتر می‌آموزید. فعلاً، اصلی‌ترین موردی که باید بدانید نحوه باز کردن یک پنجره خط فرمان و شکل ظاهری آن است:
بسته به نسخه ویندوز و نیز نوع کیبورد شما، یکی از موارد زیر برای شما یک command window یا خط فرمان باز خواهد کرد (شاید باید کمی امتحان کنید ولی لازم نیست تمام این پیشنهادات را آزمایش کنید):
- به منوی استارت یا screen بروید و عبارت "Command Prompt" را در بخش جستجو وارد کنید.
- این مسیر را دنبال کنید Start menu → Windows System → Command Prompt.
- این مسیر را دنبال کنید Start menu → All Programs → Accessories → Command Prompt.
- به بخش Start بروید و موس را روی صفحه تکان دهید و به گوشه پایین سمت چپ بروید و بر روی فلش به سمت پایین که ظاهر می‌شود کلید کنید (در یک سیستم تاچ اسکرین باید از پایین اسکرین را لمس کنید و دست خود را بالا بکشید). صفحه App ها باید باز شود. بر روی Command Prompt در بخش Windows System کلیک کنید.
- کلید مخصوص Windows را بر روی کیبورد نگه دارید و دکمه "X" را بزنید. "Command Prompt" را از پنجره‌ای که باز می‌شود انتخاب کنید.
- کلید Windows را نگه دارید و دکمه "R" را بزنید تا پنجره "Run" بازشود. تایپ کنید "cmd" و کلید OK را بزنید.
بعداً در این دوره آموزشی احتیاج دارید که دو پنجره خط فرمان به طور همزمان باز داشته باشید. با این حال در برخی نسخه‌های ویندوز، اگر یک پنجره خط فرمان باز داشته باشید و از همان روش برای باز کردن یک پنجره خط فرمان دیگری استفاده کنید به جای باز شدن پنجره جدید، همان قبلی دوباره نشان داده می‌شود. حالا روی کامپیوتر خود امتحان کنید و ببینید چه اتفاقی می‌افتد! اگر فقط یک پنجره خط فرمان دریافت کردید، یک روش دیگر از این لیست بالا را امتحان کنید. حداقل یکی از این‌ها باید یک پنجره جدید خط فرمان بازکند.
نصب پایتون
برای خوانندگان در خانه: این فصل در ویدئو نصب پایتون و ویرایشگر کد توضیح داده شده است.
این قسمت بر اساس دوره آموزشی Geek Girls Carrots نوشته شده است.(https://github.com/ggcarrots/django-carrots)
جنگو با پایتون نوشته شده است. برای انجام هر کاری در جنگو، به زبان پایتون احتیاج داریم. بیایید با نصب پایتون شروع کنیم! ما می‌خواهیم شما آخرین نسخه پایتون 3 را نصب کنید، بنابراین اگر هرنسخه قدیمی تری دارید باید آن را به روزرسانی کنید. اگر نسخه پایتون 3.4 یا جدیدتر آن را دارید برای این برنامه کافی است.
حتی اگر بر روی کامپیوتر شما Anaconda نصب شده است، لطفاً پایتون معمولی را به روش زیر نصب کنید.
ابتدا چک کنید که کامپیوتر شما دارای ویندوز 32-bit است یا 64-bit، در ردیف "System type" در صفحه System Info میتوانید این را متوجه شوید. برای پیدا کردن این صفحه یکی از کارهای زیر را انجام دهید:
- دکمه Windows و دکمه Pause/Break را همزمان روی کیبورد فشار دهید
- Control Panel را از منو ویندوز باز کنید، سپس به System & Security بروید و بعد از آن به System بروید
- دکمه Windows را فشار دهید، سپس مسیر Settings > System > About را دنبال کنید
میتوانید پایتون برای ویندوز را از وبسایت https://www.python.org/downloads/windows/ دانلود کنید. بر روی لینک "Latest Python 3 Release - Python x.x.x" کلیک کنید. اگر کامپیوتر شما نسخه 64-bit ویندوز را اجرا می‌کند، Windows x86-64 executable installer را دانلود کنید. در غیر اینصورت، Windows x86 executable installer را دانلود کنید. پس از دانلود کردن اینستالر، باید آن را اجرا کنید (بر روی آن دوبار کلیک کنید) و دستورالعمل‌ها را دنبال کنید.
نکته قابل توجه: در هنگام نصب پنجره‌ای را خواهید دید به نام "Setup". مطمئن شوید که تیک "Add Python 3.6 to PATH" یا "Add Python to your environment variables" را زده باشید و بعد دکمه "Install Now" را همانطور که در تصویر می‌بینید، بزنید (اگر از نسخه دیگری استفاده کنید ممکن است کمی متفاوت از این به نظر برسد):
وقتی که نصب کامل شد، یک پنجره خواهید دید که شما را به یک لینک برای آموزش بیشتر در مورد پایتون و نیز در مورد نسخه‌ای که نصب کرده‌اید ارجاع می‌دهد. این پنجره را کنسل کنید و یا ببندید - شما در همین دوره آموزشی بیشتر در مورد پایتون یاد خواهید گرفت!
نکته: اگر از نسخه‌های قدیمی‌تر ویندوز استفاده میکنید (7، ویستا یا نسخه های قدیمی‌تر) و نصب کننده پایتون 3.6.x خطا می‌دهد میتوانید این را امتحان کنید:
- تمام آپدیت‌های ویندوز را نصب کنید و بعد دوباره نصب کردن پایتون را امتحان کنید، یا
- یک نسخه قدیمی‌تر پایتون را مانند 3.4.6 نصب کنید.
اگر نسخه قدیمی‌تر پایتون را نصب کنید صفحه نصب با آن چیزی که در بالا دیدیم کمی متفاوت خواهد بود. مطمئن باشید که به سمت پایین اسکرول کنید تا عبارت "Add python.exe to Path" را ببینید، سپس بر روی دکمه در سمت چپ کلیک کنید و "Will be installed on local hard drive" را انتخاب کنید:
نکته قبل از نصب پایتون بر روی OS X، باید مطمئن شوید که Mac شما اجازه نصب پکیج‌های خارج از اپ استور را می‌دهد. به System Preferences بروید (در فولدر Applications است)، بر روی "Security & Privacy" کلیک کنید و سپس تب "General" را انتخاب کنید. اگر گزینه "Allow apps downloaded from:" بر روی "Mac App Store," تنظیم شده بود آن را به "Mac App Store and identified developers." تغییر دهید
لازم است که به وبسایت https://www.python.org/downloads/release/python-361/ بروید و اینستالر پایتون را نصب کنید:
- فایل Mac OS X 64-bit/32-bit installer را دانلود کنید،
- بر روی python-3.6.1-macosx10.6.pkg دابل کلیک کنید تا اینستالر اجرا شود.
احتمال زیادی دارد که شما بر روی کامپیوترتان پایتون داشته باشید. برای چک کردن آنکه آیا پایتون دارید (یا اینکه ورژن آن چیست)، یک کنسول باز کنید و دستورات زیر را تایپ کنید:
خط فرمان
$ python3 --version
Python 3.6.1
اگر شما نسخه پایتونی بالاتر از 3.4.0 دارید (مثلاً 3.6.0)، نیازی به آپگرید نیست. اگر پایتون ندارید یا نسخه متفاوت از موارد بالا دارید، ابتدا به کمک دستور زیر چک کنید که چه توزیعی از لینوکس دارید:
خط فرمان
$ grep ^NAME= /etc/os-release
بعد از آن، بسته به نتیجه، یکی از روش‌های نصب زیر را پیگیری کنید.
به وسیله باز کردن یک کنسول و اجرای دستور python3 از نصب صحیح پایتون اطمینان حاصل کنید:
خط فرمان
$ python3 --version
Python 3.6.1
نصحه نمایش داده شده ممکن است با 3.6.1 متفاوت باشد اما باید آن چیزی باشد که در موقع نصب انتخاب کرده اید.
نکته: اگر بر روی ویندوز کار میکنید و خطایی مبنی بر پیدا نکردن python3 دریافت کردید، سعی کنید از python (بدون 3) استفاده کنید. علاوه بر این چک کنید که نسخه پایتون 3.4.0 یا بالاتر باشد. اگر این هم کار نکرد، یک پنجره خط فرمان دیگر باز کنید و دوباره امتحان کنید؛ اگر یک پنجره خط فرمان را قبل از نصب پایتون باز گذاشته باشید، ممکن است چنین خطایی بگیرید.
اگر هر تردیدی داشتید یا چیزی درست کار نمی‌کرد و نمی‌دانستید چطور باید پیش بروید از مربی خود کمک بگیرید! بعضی از مواقع کارها خوب پیش نمی‌رود و بهتر است از کسی که تجربه بیشتری دارد کمک بگیرید.
نصب یک ویرایشگر متنی
ویرایشگرهای مختلف زیادی وجود دارد که این امر به سلیقه شخصی برمی‌گردد. اغلب برنامه‌نویسان پایتون از محیط‌های توسعه یکپارچه (IDE, Integrated Development Environments) بسیار قدرتمند مثل PyCharm استفاده می‌کنند. اما برای یک مبتدی احتمالا خیلی مناسب نیست. پیشنهادهای ما به همان اندازه قدرتمند، اما بسیار ساده‌تر هستند.
ما موارد زیر را پیشنهاد می‌کنیم، اما میتوانید از مربی خود، ترجیحش را بپرسید. راحت‌تر است از مربی کمک بگیرید.
Visual Studio Code
Visual Studio Code یک ویرایشگر کد است که توسط مایکروسافت توسعه داده شده و برای ویندوز، لینوکس و macOS موجود است. این ویرایشگر قابلیت عیب یابی، کنترل Git از داخل نرم افزار، برجسته سازی دستورات، سیستم هوشمند کامل کردن دستورات، سیستم snippets (جلوگیری از نوشتن بخش‌های تکراری در کدها) و بازنویسی کدها است.
Gedit
Gedit یک نرم افزار آزاد و یک ویرایشگر رایگان است که برای تمام سیستم عامل‌ها موجود است.
Sublime Text 3
Sublime Text یک ویرایشگر بسیار رایج است که یک دوره آزمایشی رایگان دارد و برای تمام سیستم عامل‌ها موجود است.
Atom
Atom نیز یک ویرایشگر رایج دیگر است که نرم افزاری رایگان و آزاد است و برای ویندوز، لینوکس وOS X موجود است. Atom توسط GitHub توسعه داده شده است.
چرا ویرایشگر متن نصب می‌کنیم؟
ممکن است فکر کنید که چرا به جای استفاده از برنامه‌ای مثل Word یا Notepad، این نرم‌افزار خاص ویرایش کد را نصب می‌کنم.
دلیل اول این است که کدها نیاز دارند که به صورت متن ساده (plain text) باشند و مشکل برنامه‌هایی مثل Word یا Textedit این است که متن ساده تولید نمی‌کنند، بلکه متنی غنی (با فونت و قالب‌بندی) می‌سازند و از قالب‌های سفارشی مثل RTF (Rich Text Format) استفاده می‌کنند.
دلیل دوم این است که ویرایشگرهای متن به طور خاص برای ویرایش کد ساخته شده‌اند. بنابراین، امکاناتی مثل رنگ‌آمیزی کدها بر اساس معنایشان یا بستن خودکار نقل قول‌ها را دارند.
همه این‌ها را بعداً در عمل خواهیم دید. به زودی، شما به ویرایشگر کد خود به عنوان یکی از ابزارهای محبوبتان نگاه خواهید کرد. :)
نصب محیط مجازی و نصب جنگو
قسمتهایی از این بخش بر اساس دوره آموزشی 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 هم در لینوکس و هم در OS X محیط مجازی بسازیم. شبیه این خواهد بود:
خط فرمان
$ 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.6 myvenvنکته: اگر چنین خطایی گرفتید
خط فرمان
E: Unable to locate package python3-venvدر عوض از این دستور استفاده کنید:
خط فرمان
sudo apt install python3.6-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~=2.2.4
حالا دستور pip install -r requirements.txt را اجرا کنید تا جنگو نصب شود.
خط فرمان
(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=2.2.4 (from -r requirements.txt (line 1))
Downloading Django-2.2.4-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-2.2.4
اگر در هنگام اجرای دستور pip در ویندوز خطایی دریافت کردید لطفاً کنترل کنید که در مسیر نام پوشه‌ها هیچ پوشه‌ای اسپیس، اعراب گذاری یا کارکتر خاص در نام خود نداشته باشد (مثلا مانند این
C:\Users\User Name\djangogirls). اگر چنین است لطفاً از مسیری استفاده کنید که در آن اسپیس به کار نرفته باشد (مثلا چنین مسیریC:\djangogirls). یک محیط مجازی در پوشه جدید درست کنید سپس محیط مجازی قبلی را پاک کنید و دستور بالا را دوباره اجرا کنید. (جابجا کردن پوشه مربوط به محیط مجازی ایده خوبی نیست و باعث می‌شود محیط مجازی کار نکند. محیط مجازی با آدرس مطلق کار می‌کند)
عالی! بالاخره در نهایت آماده شدید تا یک برنامه جنگو بسازید!
نصب گیت
گیت یک "سیستم کنترل نسخه" است که توسط بسیاری از برنامه‌نویسان مورد استفاده قرار می‌گیرد. این نرم‌افزار می‌تواند تغییرات روی فایل‌ها را در طول زمان دنبال کند بنابراین میتوانید نسخه خاصی را بعداً بازیابی کنید. این قابلیت تقریباً شبیه ابزار "track changes" در برنامه‌های ویرایش متن (مانند Microsoft Word و LibreOffice Writer) است اما به مراتب از آنها قویتر است.
نصب گیت
برای نصب گیت میتوانید آن را از git-scm.com دانلود کنید. همه جا میتوانید کلید next را بزنید به غیر از دو جا: جایی که در مورد ویرایشگر متن از شما می‌پرسد شما باید ویرایشگر Nano را انتخاب کنید و در مرحله‌ای که عنوان آن "Adjusting your PATH environment" است، گزینه "Use Git and optional Unix tools from the Windows Command Prompt" (گزینه آخر) را انتخاب کنید. در بقیه موارد، پیش فرض‌ها مناسب هستند. گزینه "Checkout Windows-style, commit Unix-style line endings" را انتخاب کنید.
فراموش نکنید که بعد از اینکه نصب به پایان رسید command prompt یا powershell را از نو باز کنید.
گیت را از git-scm.com دانلود کنید و دستورالعمل‌ها را دنبال کنید.
نکته اگر شما از OS X نسخه 10.6، 10.7 یا 10.8 استفاده میکنید باید GIT را از اینجا نصب کنید: نصب Git برای OS X Snow Leopard
ساخت یک حساب کاربری GitHub
به GitHub.com بروید و برای یک حساب کاربری جدید و رایگان، ثبت نام کنید. از بخاطر سپردن رمز عبور خود اطمینان حاصل کنید (اگر از یک نرم افزار مدیریت رمزهای عبور استفاده میکنید، رمز عبور جدید را به آن اضافه کنید).
ساخت یک حساب کاربری PythonAnywhere
PythonAnywhere سرویسی است که برای اجرای کدهای نوشته شده با پایتون در سرورهای ابری استفاده می‌شود. ما از آن برای میزبانی سایت خود و قرار دادن آن بر روی اینترنت استفاده خواهیم کرد.
بلاگی که در حال ساختن آن هستیم را بر روی PythonAnywhere قرار خواهیم داد. برای استفاده از سرویس PythonAnywhere میتوانید به صورت رایگان به عنوان تازه کار در آن ثبت نام کنید (ثبت نام به صورت تازه کار برای کار ما کفایت می کند. نیازی به ورود کارت اعتباری نیست).
نکته: هنگام انتخاب نام کاربری خود به این نکته توجه داشته باشید که آدرس بلاگ شما با نام کاربری شما به صورت
yourusername.pythonanywhere.comمشخص خواهد شد. بنابراین علاوه بر استفاده از نام خود به عنوان نام کاربری، میتوانید از یک اسم دلخواه برای بلاگ خود استفاده کنید. هچینین رمز عبور خود را به خاطر داشته باشید.
ایجاد API توکن PythonAnywhere
این کار را فقط یکبار هنگام شروع انجام خواهید داد. پس از اینکه در PythonAnywhere ثبت نام کردید به داشبورد خود هدایت خواهید شد. در سمت راست بالای صفحه بر روی Account خود کلیک کنید:
سپس به تب "API token" رفته و "Create new API token" را بزنید.
شروع کنید و آموزش‌ها را بخوانید
تبریک، شما کاملاً آماده شروع هستید. اگر هنوز پیش از شروع کارگاه زمان دارید، خواندن بخش‌های ابتدایی برایتان مفید خواهد بود:
از کارگاه لذت ببرید!
زمانی که کارگاه را شروع کردید، میتوانید مستقیماً به بخش اولین پروژه جنگو شما بروید، چون قبلاً مطالب بخش‌های پیش از آن را مرور کرده اید.