Если ты не используешь Chromebook, можешь пропустить эту секцию. В противном случае процесс установки будет немного другим, и тебе нужно будет пройти только эту инструкцию по установке.

Облачная IDE (PaizaCloud Cloud IDE, AWS Cloud9)

Облачная IDE — это инструмент, который предоставляет тебе редактор кода и доступ к компьютеру, запущенному в интернете. На этом удалённом компьютере ты можешь устанавливать, создавать и запускать программы. На время прохождения этого руководства облачная IDE будет вести себя как локальный компьютер. Ты будешь так же, как и другие участницы с macOS, Ubuntu или Windows, выполнять команды в командной строке, но она будет подключена к компьютеру облачной IDE, который находится где-то в другом месте.

Ниже ты увидишь инструкции для настройки облачных IDE (PaizaCloud Cloud IDE, AWS Cloud9). Ты можешь выбрать одну из них и выполнить соответствующие действия.

PaizaCloud Cloud IDE

1. Перейди на сайт PaizaCloud Cloud IDE
2. Войди в свой аккаунт
3. Нажми New Server
4. Нажми кнопку Terminal (в левой части окна)

Теперь ты должна увидеть интерфейс с боковой панелью, кнопки расположены слева. Нажми кнопку "Terminal", чтобы открыть командную строку. Ты увидишь приглашение командной строки:

Terminal

$

Командная строка в PaizaCloud Cloud IDE готова к твоим командам. Ты можешь изменить размер этого окна, чтобы сделать его немного больше.

AWS Cloud9

1. Перейди на сайт AWS Cloud9
2. Войди в свой аккаунт
3. Нажми Create Environment

Теперь ты должна увидеть интерфейс с боковой панелью, большим основным окном с текстом, а также маленьким окошком снизу, которое выглядит как-то так:

bash

yourusername:~/workspace $

Эта область внизу и есть твоя командная строка. Ты можешь использовать её, чтобы давать команды удалённому компьютеру в Cloud9. Ты можешь изменить размер этого окна, чтобы сделать его немного больше.

Виртуальное окружение

Виртуальное окружение (его также называют virtualenv) похоже на личную коробку, куда мы можем сложить полезный код для проекта, над которым работаем. Виртуальные окружения нужны нам, чтобы держать отдельно разные кусочки кода для наших проектов — так они не перемешаются между разными проектами.

В твоей командной строке в нижней части интерфейса Cloud 9 запусти следующие команды:

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~=5.1.2

(обрати внимание, что в последней строчке мы используем сочетание тильды и знака равенства: ~=).

GitHub

Создай аккаунт на GitHub.

PythonAnywhere

Руководство Django Girls включает в себя раздел «Публикация». Этим словом описывается процесс, когда ты переносишь код, запускающий твоё новое веб-приложение, на публично доступный компьютер (он называется сервер), чтобы другие люди могли видеть результаты твоей работы.

Если ты проходишь это руководство на Chromebook, этап публикации может выглядеть немного нетипично, так как для разработки мы уже используем удалённый компьютер где-то в интернете (а, например, не мощности своего ноутбука). Тем не менее, будет полезно пройти раздел «Публикация», ведь мы можем рассматривать наше рабочее пространство в Cloud9 или PaizaCloud как место для незавершенной работы, а PythonAnywhere как место для демонстрации законченных дел.

Так что тебе нужно будет завести аккаунт на сайте www.pythonanywhere.com.

В зависимости от твоей версии Windows и того, какая у тебя клавиатура, одно из следующих действий откроет окно командной строки (возможно, придётся немного поэкспериментировать, но все варианты пробовать необязательно):

• Перейди в меню Пуск (или на экран Пуск), в строке поиска набери "Командная строка".
• Перейди в меню Пуск → Windows → Командная строка.
• Перейди в меню Пуск → Все программы → Служебные → Командная строка.
• Перейди на экран Пуск, наведи мышь на нижний левый угол экрана и нажми на стрелочку вниз, которая появится там. (Если у тебя тачскрин, листни пальцем снизу вверх.) Откроется страница "Приложения". Выбери пункт "Командная строка" в разделе "Windows".
• Удерживая клавишу Windows на клавиатуре, нажми X. В появившемся меню выбери пункт "Командная строка".
• Удерживая клавишу Windows, нажми R, чтобы появилось окно "Выполнить". Набери в строке cmd и нажми OK.

В какой-то момент тебе понадобятся два окна командной строки одновременно. Однако в некоторых версиях Windows, если ты попытаешься запустить вторую командную строку, когда одна уже запущена тем же способом, ты вместо этого попадёшь в уже открытое окно командной строки. Попробуй у себя на компьютере и посмотри, что будет! Если у тебя получается открыть только одно окно командной строки, попробуй какой-нибудь другой из вышеприведённых способов в списке. По крайней мере один из них сможет открыть новое окно командной строки.

Перейди в Приложения → Прочие → Терминал.

Вероятно, командная строка скрывается по адресу: Приложения → Стандартные → Терминал или Приложения → Система → Терминал, но это может зависеть от конкретной системы. Если не сможешь найти — Google поможет :)

Для начала проверь, какая версия Windows у тебя на компьютере — 32-битная или 64-битная. Это будет указано в строке «Тип системы» на странице «Сведения о системе». Чтобы попасть туда, попробуй один из этих способов:

• Нажми одновременно клавиши Windows и Pause/Break
• Открой панель управления из меню Windows, оттуда перейди в «Система и безопасность», затем в «Система»
• Нажми клавишу Windows, затем перейди по разделам Настройки > Система > О системе

Ты можешь загрузить Python для Windows с официального веб-сайта: https://www.python.org/downloads/windows/. Перейди по ссылке «Latest Python 3 Release - Python x.x.x». Если у тебя установлена 64-битная версия Windows, скачай Windows installer (64-bit). Если нет — скачай Windows installer (32-bit). После загрузки дистрибутива ты должна запустить его (двойным щелчком) и следовать инструкциям.

Обрати внимание на экран мастера установки, который называется «Setup» (Настройка): тебе нужно пролистать его вниз и выбрать опцию «Add Python 3.12 to the PATH» (Добавить Python 3.12 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую ты устанавливаешь):

Когда установка закончится, ты можешь увидеть предложение узнать больше о Python или об установленной тобой версии. Закрой это окно — ты узнаешь намного больше в этом руководстве!

Примечание: если ты используешь старую версию Windows (7, Vista или ещё более старую версию), и установка Python 3.12 завершается выводом сообщения об ошибке, ты можешь попробовать:

1. либо установить все доступные обновления Windows и попробовать установить Python 3.12 заново;
2. либо установить более раннюю версию Python, например, 3.4.6.

Если тебе пришлось установить раннюю версию Python, экран установки может выглядеть чуть иначе, чем показано выше. Не забудь прокрутить окно до строки «Add python.exe to Path», затем нажми кнопку слева от неё и выбери пункт «Will be installed on local hard drive»:

Примечание: перед установкой Python в macOS тебе нужно проверить, что в настройках твоего Mac разрешено устанавливать пакеты, загруженные не из App Store. Перейди в Системные настройки (в папке «Программы»), нажми «Защита и безопасность» и выбери вкладку «Общие». Если в разделе «Разрешать загрузки из:» выбран вариант «App Store для Mac», смени его на «App Store для Mac и от установленных разработчиков».

Тебе нужно перейти по ссылке https://www.python.org/downloads/ и скачать дистрибутив Python:

• Скачай файл macOS installer,
• Сделай двойной щелчок на python-3.12.3-macosx11.pkg для запуска установщика.

Вполне вероятно, что у тебя уже установлен Python. Чтобы проверить это (а также версию языка), открой консоль и введи следующую команду:

command-line

$ python3 --version
Python 3.12.3

Если у тебя установлена другая версия Python, не меньше чем 3.10 (например, 3.10.13), то нет необходимости обновляться. Если Python не установлен, или ты хочешь использовать другую версию языка, то можешь установить его следующим образом:

Введи эту команду в консоль:

command-line

$ sudo apt install python3

Используй следующую команду в консоли:

command-line

$ sudo dnf install python3

Если у тебя старая версия Fedora, то ты можешь получить ошибку «command dnf is not found». В этом случае используй yum.

Используй следующую команду в консоли:

command-line

$ sudo zypper install python3

Чтобы создать новое virtualenv, тебе нужно открыть командную строку и набрать python -m venv myvenv. Это будет выглядеть так:

command-line

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

Здесь myvenv — имя твоего virtualenv. Ты можешь выбрать другое имя, но используй только строчные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче — тебе придётся часто его набирать!

В Linux и macOS достаточно набрать python3 -m venv myvenv, чтобы создать virtualenv:

command-line

$ python3 -m venv myvenv

myvenv — имя виртуального окружения virtualenv. Можешь выбрать другое имя, но используй только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — набирать его предстоит не раз!

Примечание: В некоторых версиях Debian/Ubuntu может произойти следующая ошибка:

command-line

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:

command-line

$ sudo apt install python3-venv

Примечание: В некоторых версиях Debian/Ubuntu при таком способе создания виртуального окружения ты можешь получить такую ошибку:

command-line

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

Чтобы обойти её, используй команду virtualenv.

command-line

$ sudo apt install python-virtualenv
$ virtualenv --python=python3.12 myvenv

Примечание: Если ты получаешь следующую ошибку

command-line

E: Unable to locate package python3-venv

то запусти команду:

command-line

sudo apt install python3.12-venv

Запусти виртуальное окружение, выполнив:

command-line

C:\Users\Name\djangogirls> myvenv\Scripts\activate

ПРИМЕЧАНИЕ: в Windows 10 при работе в Windows PowerShell ты можешь получить ошибку вида execution of scripts is disabled on this system. В этом случае открой ещё одно окно Windows PowerShell, выбрав опцию «Запустить от имени Администратора». Затем перед использованием виртуального окружения попробуй запустить следующую команду:

command-line

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

Запусти виртуальное окружение, выполнив:

command-line

$ source myvenv/bin/activate

Не забудь поменять myvenv на выбранное тобой имя для virtualenv!

ПРИМЕЧАНИЕ: иногда команда source может быть недоступна. В таком случае используй следующий метод:

command-line

$ . myvenv/bin/activate

Если при запуске pip в Windows ты получаешь сообщение об ошибке, проверь, что путь к директории с проектом не содержит пробелов или специальных символов (C:\Users\User Name\djangogirls). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелов и специальных символов (предлагаем C:\djangogirls). Создай новое виртуальное окружение в новой директории, после этого удали старое и попробуй запустить команды выше заново (перемещение виртуального окружения не сработает, поскольку в нём используются абсолютные пути).

При попытке установки Django твоя командная строка может зависнуть. Если это произошло, вместо приведённой выше команды используй:

command-line

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

При возникновении ошибки при вызове pip под Ubuntu 12.04, пожалуйста, запусти `python -m pip install -U --force-reinstall pip`, чтобы исправить установку pip в virtualenv.

Ты можешь загрузить Git с официального сайта git-scm.com. Ты можешь нажимать "дальше, дальше, дальше" на всех этапах установки за исключением одного: на пятом шаге, который называется "Adjusting your PATH environment" (Настройка системной переменной Path), выбери "Use Git and optional Unix tools from the Windows Command Prompt" (Запуск Git и соответствующих Unix утилит через командную строку Windows, нижняя опция). Все остальные настройки можно оставить по умолчанию. Также неплохо будет выбрать опцию "Checkout Windows-style, commit Unix-style line endings".

После окончания установки не забудь перезапустить командную строку или PowerShell.

Загрузи Git с официального сайта git-scm.com и просто следуй инструкциям по установке.

Примечание: если ты используешь OS X 10.6, 10.7 или 10.8, тебе придётся установить git отсюда: Установка Git для OS X Snow Leopard

command-line

$ sudo apt install git

command-line

$ sudo dnf install git

command-line

$ sudo zypper install git