اگر این آموزش را در خانه دنبال می‌کنید

اگر این آموزش را در خانه دنبال می‌کنید و نه در یکی از رویدادهای دختران جنگو، می‌توانید به طور کامل از این بخش بگذرید و به بخش اینترنت چگونه کار می‌کند بروید.

به دلیل اینکه ما نصب کردن هر چیزی را که دراین سری آموزشی نیاز است، در محل مورد نیاز بیان می‌کنیم. این صفحه تنها برای بیان همه دستورات نصب در یک مکان، اضافه شده است (که برای برخی کارگاه‌ها مفید است). شما می‌توانید هرچیزی که در این بخش آمده است را نصب کنید. اما اگر ترجیح می‌دهید پیش از نصب چند ابزار و نرم افزار روی کامپیوترتان، در مورد آن‌ها یاد بگیرید، از این بخش عبور کنید. ما نحوه‌ی نصب هر چیزی را، زمانی که به آن نیاز داشتید، توضیح می‌دهیم.

موفق باشید!

اگر در یک کارگاه شرکت کرده‌اید

اگر در یکی از رویدادهای جنگو برای دختران شرکت کرده اید:

  • ممکن است کارگاه شما یک "جلسه نصب پیش‌نیازها" قبل از رویداد اصلی داشته باشد. اگر در جلسه نصب پیش‌نیازها هستید، این بخش مخصوص شماست! برای نصب هرچیزی که در این رویداد نیاز دارید، دستورالعمل‌های این بخش را دنبال کنید، و در صورت نیاز از مربی‌ها کمک بگیرید. سپس در کارگاه اصلی، می‌توانید از دستورالعمل‌های نصب که در آموزش اصلی با آنها مواجه می‌شوید، عبور کنید.
  • ممکن است برگزار کنندگان کارگاه، از شما بخواهند تا سعی کنید همه چیز را قبل از شروع کارگاه روی کامپیوترتان نصب کنید. اگر از شما این درخواست را داشته اند، این بخش برای شماست! به بهترین نحو دستورالعمل های این بخش را دنبال کنید. اگر نتوانستید چیزی را نصب کنید، در کارگاه اصلی، زمانی که به دستورالعمل‌های نصب آن بخش در آموزش اصلی می‌رسید، می‌توانید از مربی‌ها کمک بگیرید.
  • اگر کارگاه شما فاقد جلسه نصب پیش نیازها بود (یا شما نتوانستید در آن شرکت کنید)، و اگر برگزارکنندگان از شما نخواستند که همه چیز را پیش از شروع رویداد نصب کنید، از این بخش عبور کنید و مستقیم به بخش اینترنت چگونه کار می‌کند بروید. شما هر چیزی را که به آن نیاز دارید، در طول آموزش اصلی نصب خواهید کرد.

نصب پیش‌نیازها

در این آموزش شما یک وبلاگ خواهید ساخت. برای انجام این کار، در خلال روند آموزش، به شما نحوه‌ی نصب نرم‌افزارهای مختلف روی کامپیوترتان و نحوه‌ی راه اندازی چند حساب اینترنتی گفته خواهد شد. این بخش شامل تمام مراحل نصب و دستورالعمل‌های ثبت نام است (که برای بعضی از کارگاه‌ها مفید است).

Chromebook setup (if you're using one)

اگر از Chromebook استفاده نمی‌کنید می‌توانید از این بخش عبور کنید. اگر از آن استفاده می‌کنید تجربه نصب شما کمی متفاوت خواهد بود. شما می توانید بقیه دستورالعمل نصب را نادیده بگیرید.

IDE ابری (PaizaCloud Cloud IDE, AWS Cloud9)

IDE ابری ابزاری است که به شما دسترسی به یک ویرایشگر کد و یک کامپیوتر در حال کار کردن روی اینترنت را می‌دهد که می‌توانید نصب، نوشتن و اجرای برنامه‌ها را در آن انجام دهید. در زمان این آموزش، IDE ابری به عنوان دستگاه محلی شما عمل خواهد کرد. شما همچنان مانند سایر همکلاسی‌ها که از OS X، اوبونتو یا ویندوز استفاده می‌کنند، دستورات را در ترمینال اجرا خواهید کرد اما ترمینال شما به کامپیوتری که IDE ابری برای شما آماده کرده متصل است. در اینحا دستورالعمل استفاده از IDE های ابری (PaizaCloud Cloud IDE و AWS Cloud9) را خواهید دید. شما می‌توانید یکی از IDE های ابری را انتخاب کنید و دستورالعمل را دنبال کنید.

IDE ابری PiazaCloud

  1. به PaizaCloud Cloud IDE بروید
  2. یک حساب کاربری بسازید
  3. بر روی New Server کلیک کنید
  4. دکمه Terminal را (در سمت چپ صفحه) بزنید

حالا شما باید صفحه ای با یک ستون کناری و کلیدهایی در سمت چپ ببینید. بر روی دکمه "Terminal" کلیک کنید تا پنجره ترمینال با پیغامی شبیه به این باز شود:

Terminal

$

ترمینال در IDE ابری PiazaCloud برای دستورات شما آماده شده است. شما می‌توانید اندازه این پنجره را تغییر دهید تا کمی بزرگتر دیده شود.

AWS Cloud9

  1. به AWS Cloud9 بروید
  2. یک حساب کاربری بسازید
  3. Create Environment را کلیک کنید

حالا شما باید یک صفحه با یک ستون کناری، یک پنجره اصلی بزرگ به همراه مقداری نوشته و یک پنجره کوچک در پایین، شبیه به این ببینید:

bash

yourusername:~/workspace $

این پنجره پایینی ترمینال شما است. شما می‌توانید برای فرستادن دستورات به کامپیوتر Cloud9 از این پنجره استفاده کنید. با تغییر اندازه این پنجره می‌توانید آن را کمی بزرگتر ببینید.

محیط مجازی

یک محیط مجازی (Virtual Environment یا virtualenv) شبیه یک جعبه شخصی است که ما می‌توانیم کدهای کامپیوتری مربوط به یک پروژه را در آن جمع کنیم. ما از آن‌ها استفاده می‌کنیم تا تکه‌های مختلف کدهای هر پروژه را جدا از پروژه دیگر نگه داریم تا بین پروژه‌ها تداخل پیش نیاید.

در ترمینال پایین صفحه Cloud9 دستور زیر را اجرا کنید:

Cloud 9

sudo apt update 
sudo apt install python3.6-venv

اگر این دستور کار نکرد از مربی خود کمک بگیرید.

بعد، دستور زیر را اجراکنید:

Cloud 9

mkdir djangogirls 
cd djangogirls
 python3.6 -mvenv myvenv 
source myvenv/bin/activate 
pip install django~=2.2.4

(توجه کنید که در خط آخر ما از یک علامت مد و یک مساوی استفاده کردیم: ~=).

GitHub

یک حساب گیت هاب ایجاد کنید.

PythonAnywhere

تمرین جنگو گرلز شامل بخشی است که به آن انتشار یا Deployment، می‌گوییم که در این فرایند کد مربوط به وب اپلیکیشن را به یک کامپیوتر در دسترس و عمومی (به نام سرور) منتقل می‌کنیم تا سایرین بتوانند کار شما را ببینند.

اگر تمرین را بر روی یک Chromebook انجام می‌دهید ممکن است این بخش کمی عجیب باشد به خاطر اینکه ما از یک کامپیوتر بر روی اینترنت استفاده می‌کنیم (بر خلاف یک لپ تاپ). با این‌حال، استفاده از Cloud 9 به عنوان یک محیط کاری برای کارهای در جریان و استفاده از Python Anywhere به عنوان یک فضای معرفی و نمایش پروژه هایی که در طول زمان کامل می‌شوند، مفید است.

یک حساب کاربری در www.pythonanywhere.com ایجاد کنید.

معرفی کوتاه کنسول خط فرمان

بسیاری از مراحل زیر به "کنسول"، "ترمینال"، "پنجره دستورات" یا "خط فرمان" اشاره می‌کنند ـ همه آنها یک معنا دارند: یک پنجره روی کامپیوتر شما که می‌توانید دستوراتی را در آن وارد کنید. زمانی که به آموزش اصلی رسیدید، در مورد خط فرمان بیشتر می‌آموزید. فعلاً، اصلی‌ترین موردی که باید بدانید نحوه باز کردن یک پنجره خط فرمان و شکل ظاهری آن است:

Opening: Windows

بسته به نسخه ویندوز و نیز نوع کیبورد شما، یکی از موارد زیر برای شما یک 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 را بزنید.

در پنجره "Run" بنویسید "cmd"

بعداً در این دوره آموزشی احتیاج دارید که دو پنجره خط فرمان به طور همزمان باز داشته باشید. با این حال در برخی نسخه‌های ویندوز، اگر یک پنجره خط فرمان باز داشته باشید و از همان روش برای باز کردن یک پنجره خط فرمان دیگری استفاده کنید به جای باز شدن پنجره جدید، همان قبلی دوباره نشان داده می‌شود. حالا روی کامپیوتر خود امتحان کنید و ببینید چه اتفاقی می‌افتد! اگر فقط یک پنجره خط فرمان دریافت کردید، یک روش دیگر از این لیست بالا را امتحان کنید. حداقل یکی از این‌ها باید یک پنجره جدید خط فرمان بازکند.

Opening: OS X

به اینجا بروید Applications → Utilities → Terminal.

Opening: Linux

احتمالاً Applications → Accessories → Terminal یا Applications → System → Terminal است که بستگی به سیستم کامپیوتر شما دارد. اگر در این آدرس‌ها پیدا نکردید سعی کنید با جستجو در گوگل جای آن را پیدا کنید. :)

نصب پایتون

برای خوانندگان در خانه: این فصل در ویدئو نصب پایتون و ویرایشگر کد توضیح داده شده است.

این قسمت بر اساس دوره آموزشی Geek Girls Carrots نوشته شده است.(https://github.com/ggcarrots/django-carrots)

جنگو با پایتون نوشته شده است. برای انجام هر کاری در جنگو، به زبان پایتون احتیاج داریم. بیایید با نصب پایتون شروع کنیم! ما می‌خواهیم شما آخرین نسخه پایتون 3 را نصب کنید، بنابراین اگر هرنسخه قدیمی تری دارید باید آن را به روزرسانی کنید. اگر نسخه پایتون 3.4 یا جدیدتر آن را دارید برای این برنامه کافی است.

حتی اگر بر روی کامپیوتر شما Anaconda نصب شده است، لطفاً پایتون معمولی را به روش زیر نصب کنید.

Install Python: Windows

ابتدا چک کنید که کامپیوتر شما دارای ویندوز 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" را همانطور که در تصویر می‌بینید، بزنید (اگر از نسخه دیگری استفاده کنید ممکن است کمی متفاوت از این به نظر برسد):

فراموش نکنید که پایتون را به Path اضافه کنید

وقتی که نصب کامل شد، یک پنجره خواهید دید که شما را به یک لینک برای آموزش بیشتر در مورد پایتون و نیز در مورد نسخه‌ای که نصب کرده‌اید ارجاع می‌دهد. این پنجره را کنسل کنید و یا ببندید - شما در همین دوره آموزشی بیشتر در مورد پایتون یاد خواهید گرفت!

نکته: اگر از نسخه‌های قدیمی‌تر ویندوز استفاده می‌کنید (7، ویستا یا نسخه های قدیمی‌تر) و نصب کننده پایتون 3.6.x خطا می‌دهد می‌توانید این را امتحان کنید:

  1. تمام آپدیت‌های ویندوز را نصب کنید و بعد دوباره نصب کردن پایتون را امتحان کنید، یا
  2. یک نسخه قدیمی‌تر پایتون را مانند 3.4.6 نصب کنید.

اگر نسخه قدیمی‌تر پایتون را نصب کنید صفحه نصب با آن چیزی که در بالا دیدیم کمی متفاوت خواهد بود. مطمئن باشید که به سمت پایین اسکرول کنید تا عبارت "Add python.exe to Path" را ببینید، سپس بر روی دکمه در سمت چپ کلیک کنید و "Will be installed on local hard drive" را انتخاب کنید:

اضافه کردن پایتون به Path در نسخه‌های قدیمی

Install Python: OS X

نکته قبل از نصب پایتون بر روی 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 دابل کلیک کنید تا اینستالر اجرا شود.
Install Python: Linux

احتمال زیادی دارد که شما بر روی کامپیوترتان پایتون داشته باشید. برای چک کردن آنکه آیا پایتون دارید (یا اینکه ورژن آن چیست)، یک کنسول باز کنید و دستورات زیر را تایپ کنید:

خط فرمان

$ python3 --version
Python 3.6.1

اگر شما نسخه پایتونی بالاتر از 3.4.0 دارید (مثلاً 3.6.0)، نیازی به آپگرید نیست. اگر پایتون ندارید یا نسخه‌ متفاوت از موارد بالا دارید، ابتدا به کمک دستور زیر چک کنید که چه توزیعی از لینوکس دارید:

خط فرمان

$ grep ^NAME= /etc/os-release

بعد از آن، بسته به نتیجه، یکی از روش‌های نصب زیر را پیگیری کنید.

Install Python: Debian or Ubuntu

این دستور را در کنسول تایپ کنید:

خط فرمان

$ sudo apt install python3
Install Python: Fedora

این دستور را در کنسول تایپ کنید:

خط فرمان

$ sudo dnf install python3

اگر بر روی نسخه‌های قدیمی Fedora کار می‌کنید ممکن است پیغام خطایی بگیرید که dnf پیدا نشد. در این مورد، باید به جای آن از yum استفاده کنید.

Install Python: openSUSE

این دستور را در کنسول تایپ کنید:

خط فرمان

$ sudo zypper install python3

به وسیله باز کردن یک کنسول و اجرای دستور 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
Virtual environment: Windows

برای ایجاد یک محیط مجازی جدید، باید کنسول خط فرمان را باز کنید و دستور <python -m venv myvenv را اجرا کنید. شبیه این خواهد شد:

خط فرمان

C:\Users\Name\djangogirls> python -m venv myvenv

در اینجا myvenv نام محیط مجازی شماست. می‌توانید هر نام دیگری انتخاب کنید اما از حروف کوچک استفاده کنید و از اسپیس، اعراب گذاری و کاراکترهای خاص استفاده نکنید. همچنین بهتر است اسم کوتاهی انتخاب کنید چون بعدتر ارجاعات زیادی به آن خواهید داشت!

Virtual environment: Linux and OS X

می‌توانیم با دستور 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 می‌سازد (یا هر نام دیگری که شما گذاشته باشید) که شامل محیط مجازی ماست (درواقع مجموعه‌ای از پوشه‌ها و فایل‌ها).

Working with virtualenv: Windows

محیط مجازی خود را با اجرای دستور زیر فعال کنید:

خط فرمان

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
Working with virtualenv: Linux and OS X

محیط مجازی را با دستور زیر فعال کنید:

خط فرمان

$ source myvenv/bin/activate

به یاد داشته باشید که myvenv را با نامی که برای محیط مجازی خود انتخاب کرده‌اید عوض کنید!

نکته: گاهی اوقات ممکن است دستور source در دسترس نباشد. در این مواقع دستور زیر را امتحان کنید:

خط فرمان

$ . myvenv/bin/activate

نکته: برای کاربران ویرایشگر VS Code که درون خود یک ترمینال خط فرمان منطبق بر powershell ویندوز دارد، اگر بخواهید از این ترمینال استفاده کنید باید این دستور را برای فعال کردن محیط مجازی خود بزنید:

$ . myvenv\Scripts\activate.ps1

فایده این کار این است که لازم نیست دائم بین پنجره ویرایشگر و پنجره خط فرمان جابجا شوید

هنگامی که پیشوند (myvenv) در کنسول خط فرمان اضافه شود به معنی آن است که محیط مجازی شما فعال شده است.

وقتی درون یک محیط مجازی کار می‌کنید کلمه python به صورت اتوماتیک به نسخه صحیح پایتون ارجاع می‌دهد در نتیجه می‌توانید به جای python3 از python استفاده کنید.

بسیار خوب، ما همه نیازمندی‌ها را داریم حالا می‌توانیم جنگو را نصب کنیم!

نصب جنگو

حالا که محیط مجازی شما فعال شده است می‌توانید جنگو را نصب کنید.

قبل از آن باید مطمئن شویم که آخرین نسخه pip که برای نصب جنگو استفاده می‌شود را داریم:

خط فرمان

(myvenv) ~$ python -m pip install --upgrade pip

نصب پکیج‌ها و پیش‌نیازهایشان

یک فایل پیش‌نیازها شامل لیستی از پکیج‌های وابسته است که باید به کمک pip install نصب شوند:

در ابتدا یک فایل requirements.txt در پوشه djangogirls/ بسازید. معمولاً می‌توانید از خود ویرایشگر کد که قبل‌تر نصب کرده‌اید هم برای ساختن فایل جدید استفاده کنید. یک فایل جدید در ویرایشگر کد بسازید و سپس به نام requirements.txtدر پوشه djangogirls/ ذخیره‌اش کنید. پوشه شما شبیه این خواهد بود:

djangogirls
└───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
Installing Django: Windows

اگر در هنگام اجرای دستور pip در ویندوز خطایی دریافت کردید لطفاً کنترل کنید که در مسیر نام پوشه‌ها هیچ پوشه‌ای اسپیس، اعراب گذاری یا کارکتر خاص در نام خود نداشته باشد (مثلا مانند این C:\Users\User Name\djangogirls). اگر چنین است لطفاً از مسیری استفاده کنید که در آن اسپیس به کار نرفته باشد (مثلا چنین مسیری C:\djangogirls). یک محیط مجازی در پوشه جدید درست کنید سپس محیط مجازی قبلی را پاک کنید و دستور بالا را دوباره اجرا کنید. (جابجا کردن پوشه مربوط به محیط مجازی ایده خوبی نیست و باعث می‌شود محیط مجازی کار نکند. محیط مجازی با آدرس مطلق کار می‌کند)

Installing Django: Windows 8 and Windows 10

ممکن است کنسول خط فرمان شما بعد از اجرای دستور فوق ثابت و بی‌حرکت شود. اگر چنین اتفاقی افتاد به جای دستور بالا از خط زیر استفاده کنید:

خط فرمان

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
Installing Django: Linux

اگر هنگام اجرای دستور pip بر روی اوبونتو نسخه 12.04 پیغام خطا گرفتید از دستور python -m pip install -U --force-reinstall pip برای اصلاح پکیج pip در محیط مجازی استفاده کنید.

عالی! بالاخره در نهایت آماده شدید تا یک برنامه جنگو بسازید!

نصب گیت

گیت یک "سیستم کنترل نسخه" است که توسط بسیاری از برنامه‌نویسان مورد استفاده قرار می‌گیرد. این نرم‌افزار می‌تواند تغییرات روی فایل‌ها را در طول زمان دنبال کند بنابراین می‌توانید نسخه خاصی را بعداً بازیابی کنید. این قابلیت تقریباً شبیه ابزار "track changes" در برنامه‌های ویرایش متن (مانند Microsoft Word و LibreOffice Writer) است اما به مراتب از آن‌ها قویتر است.

نصب گیت

Installing Git: Windows

برای نصب گیت می‌توانید آن را از 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 را از نو باز کنید.

Installing Git: OS X

گیت را از git-scm.com دانلود کنید و دستورالعمل‌ها را دنبال کنید.

نکته اگر شما از OS X نسخه 10.6، 10.7 یا 10.8 استفاده می‌کنید باید GIT را از اینجا نصب کنید: نصب Git برای OS X Snow Leopard

Installing Git: Debian or Ubuntu

command-line

$ sudo apt install git
Installing Git: Fedora

command-line

$ sudo dnf install git
Installing Git: openSUSE

command-line

$ sudo zypper install git

ساخت یک حساب کاربری GitHub

به GitHub.com بروید و برای یک حساب کاربری جدید و رایگان،‌ ثبت نام کنید. از بخاطر سپردن رمز عبور خود اطمینان حاصل کنید (اگر از یک نرم افزار مدیریت رمزهای عبور استفاده میکنید، رمز عبور جدید را به آن اضافه کنید).

ساخت یک حساب کاربری PythonAnywhere

PythonAnywhere سرویسی است که برای اجرای کدهای نوشته شده با پایتون در سرورهای ابری استفاده می‌شود. ما از آن برای میزبانی سایت خود و قرار دادن آن بر روی اینترنت استفاده خواهیم کرد.

بلاگی که در حال ساختن آن هستیم را بر روی PythonAnywhere قرار خواهیم داد. برای استفاده از سرویس PythonAnywhere میتوانید به صورت رایگان به عنوان تازه کار در آن ثبت نام کنید (ثبت نام به صورت تازه کار برای کار ما کفایت می کند. نیازی به ورود کارت اعتباری نیست).

صفحه ثبت نام PythonAnywhere دارای امکان ثبت نام رایگان برای کاربران تازه کار می باشد

نکته: هنگام انتخاب نام کاربری خود به این نکته توجه داشته باشید که آدرس بلاگ شما با نام کاربری شما به صورت yourusername.pythonanywhere.com مشخص خواهد شد. بنابراین علاوه بر استفاده از نام خود به عنوان نام کاربری، می‌توانید از یک اسم دلخواه برای بلاگ خود استفاده کنید. هچینین رمز عبور خود را به خاطر داشته باشید.

ایجاد API توکن PythonAnywhere

این کار را فقط یکبار هنگام شروع انجام خواهید داد. پس از اینکه در PythonAnywhere ثبت نام کردید به داشبورد خود هدایت خواهید شد. در سمت راست بالای صفحه بر روی Account خود کلیک کنید:

لینک Account در سمت راست بالای صفحه

سپس به تب "API token" رفته و "Create new API token" را بزنید.

تب API token در صفحه Account

شروع کنید و آموزش‌ها را بخوانید

تبریک، شما کاملاً آماده شروع هستید. اگر هنوز پیش از شروع کارگاه زمان دارید، خواندن بخش‌های ابتدایی برایتان مفید خواهد بود:

از کارگاه لذت ببرید!

زمانی که کارگاه را شروع کردید، می‌توانید مستقیماً به بخش اولین پروژه جنگو شما بروید، چون قبلاً مطالب بخش‌های پیش از آن را مرور کرده اید.

results matching ""

    No results matching ""