Django Girls

  Edit This Page

Если ты занимаешься дома

Если ты занимаешься по этому руководство дома, а не на одной из встреч Django Girls, то можешь пропустить этот раздел и приступить сразу же к главе Как работает интернет?.

Дело в том, что мы всё равно рассматриваем все эти вещи по ходу руководства, а в этом разделе мы просто собрали все инструкции по установке вместе. Встречи Django Grils включают в себя "вечер настроек", когда мы устанавливаем всё что нужно, чтобы не тратить на это время в течение основного семинара, это очень удобно для нас.

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

Удачи!

Установка

В процессе мастер-класса мы будем создавать блог и у нас есть несколько подготовительных задач по установке, которые не помешало бы выполнить заранее, чтобы тебе не пришлось отвлекаться от программирования.

Установка Python

Этот подраздел основан на руководстве Geek Girls Carrots (http://django.carrots.pl/)

Django написан на Python. Нам нужен Python, чтобы сделать что-нибудь в Django. Давай начнем с его установки! Мы хотим, чтобы ты установила Python 3.4, поэтому, если у тебя уже есть более ранняя версия, то её придется обновить.

Windows

Ты можешь загрузить Python для Windows с официального веб-сайта: https://www.python.org/downloads/release/python-343/. После загрузки *.msi файла, ты должна запустить его (двойной щелчок) и следовать инструкциям. Важно помнить путь (каталог), куда ты установила Python. Это понадобится позже!

Обрати внимание на второй экран мастера установки, который называется "Customize" (Настройка): тебе нужно пролистать его вниз и выбрать опцию "Add python.exe to the Path" (Добавить python.exe к системной переменной Path), как на рисунке:

Не забудьте добавить Python в системную переменную Path

Linux

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

$ python3 --version
Python 3.4.3

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

Debian или Ubuntu

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

$ sudo apt-get install python3.4

Fedora (версии вплоть до 21)

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

$ sudo yum install python3.4

Fedora (версии 22 и выше)

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

$ sudo dnf install python3.4

OS X

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

  • Скачай файл Mac OS X 64-bit/32-bit installer,
  • Сделай двойной щелчок на python-3.4.3-macosx10.6.pkg для запуска установщика.

Убедись, что установка прошла успешно, открыв приложение Терминал и запустив команду python3:

$ python3 --version
Python 3.4.3

Если у тебя остались какие-либо сомнения, или что-то пошло не так и ты понятия не имеешь что делать дальше - спроси своего тренера! Иногда дела идут не совсем гладко, поэтому лучше попросить помощи у кого-то с большим опытом.

Настрока virtualenv и установка Django

Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (http://django.carrots.pl/).

Отдельные части этой главы основаны на учебном пособии django-marcador, лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.

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

Перед установкой Django мы попросим тебя установить крайне полезный инструмент, который поможет тебе содержать среду разработки в чистоте. Можно пропустить этот шаг, но мы очень советуем этого не делать. Использование лучших рекомендаций с самого начала убережёт от многих проблем в будущем!

Итак, давай создадим виртуальное окружение (оно также называется virtualenv). Virtualenv будет изолировать зависимости Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта никогда не затронут другие сайты, которые вы разрабатываете. Удобно, правда?

Все что тебе нужно сделать -- найти директорию, в которой мы создадим virtualenv; домашний каталог вполне подойдет. Для Windows адрес будет выглядеть так: C:\Users\Name (где Name твое имя пользователя).

Мы будем использовать отдельную директорию djangogirls в домашнем каталоге:

mkdir djangogirls
cd djangogirls

Мы создадим виртуальное окружение под именем myvenv. В общем случаем команда будет выглядеть так:

python3 -m venv myvenv

Windows

Чтобы создать новое virtualenv, тебе нужно открыть командную строку (мы рассказывали про неё в одной из прошлых глав - помнишь?) и набрать C:\Python34\python -m venv myvenv. Он должен содержать следующее:

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

где C:\Python34\python это директория, где ты установила Python и myvenv имя твоего virtualenv. Ты можешь выбрать любое имя, использовать можно только прописные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче!

Linux and OS X

Для Linux и OS X достаточно набрать python3 -m venv myvenv, чтобы создать virtualenv:

~/djangogirls$ python3 -m venv myvenv

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

ПРИМЕЧАНИЕ: создание виртуального окружения данной командой на Ubuntu 14.04 приведет к следующей ошибке:

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

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

~/djangogirls$ sudo apt-get install python-virtualenv
~/djangogirls$ virtualenv --python=python3.4 myvenv

Работаем с virtualenv

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

Windows

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

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

Linux and OS X

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

~/djangogirls$ source myvenv/bin/activate

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

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

~/djangogirls$ . myvenv/bin/activate

Ты поймешь, что virtualenv запущено, когда увидишь приписку в командной строке:

(myvenv) C:\Users\Name\djangogirls>

или:

(myvenv) ~/djangogirls$

Обрати внимание на появление префикса (myvenv)!

При работе с виртуальным окружением, команда python будет автоматически обращаться к правильной версии языка, так что тебе не обязательно использовать python3.

Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!

Установка Django

После запуска virtualenv ты можешь установить Django используя pip. Набери в командной строке строке pip install django==1.8 (обрати внимание на двойной знак равенства: ==).

(myvenv) ~$ pip install django==1.8
Downloading/unpacking django==1.8
Installing collected packages: django
Successfully installed django
Cleaning up...

для Windows

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

для Linux

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

Вот и оно! Теперь ты (наконец то) готова создать свое Django приложение!

Установка редактора кода

Существует много различных редакторов и в основном все сводится к личным предпочтениям. Большинство Python программистов используют сложные, но чрезвычайно мощные IDE (англ. Integrated Development Environments - Интегрированные среды разработки), такие как PyCharm. Однако они, вероятно, не очень подходят для начинающих; мы предлагаем столь же мощные, но куда более простые варианты.

Ниже приведен перечень наших предпочтений, но также можешь попросить совета у своего тренера - будет проще получить помощь от него.

Gedit

Gedit является открытым, бесплатным редактором, доступным для всех операционных систем.

Скачать его можно здесь

Sublime Text 2

Sublime Text - это очень популярный текстовый редактор с бесплатным пробным периодом. Он легко устанавливается и прост в использовании, а также доступен для всех операционных систем.

Скачать его можно здесь

Atom

Atom - это новейший текстовый редактор от GitHub. Он является бесплатным, открытым, легко устанавливается и прост в использовании. Доступен для Windows, OSX и Linux.

Скачать его можно здесь

Зачем нам нужен редактор кода?

Ты можешь спросить - зачем устанавливать отдельную программу для редактирования кода, если можно использовать Word или Notepad.

Во-первых, код должен должен храниться в виде простого текста, а проблема таких программ, как Word или Textedit в том, что они не сохраняют файлы в этом виде, а используют "обогащенный" текст (с форматированием и шрифтами), например, RTF (Rich Text Format).

Вторая причина в том, что специализированные редакторы предоставляют множество полезных для программирования возможностей, такие как цветную подсветку кода в зависимости от его смысла и автоматически закрывающиеся кавычки.

Позже мы увидим все это в действии. Скоро ты начнешь думать о своем редакторе кода как о проверенном любимом инструменте :)

Установка Git

Windows

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

MacOS

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

Linux

Если git ещё не установлен, то он будет доступен через менеджер пакетов, попробуй следующую команду:

sudo apt-get install git
# or
sudo yum install git

Создание учётной записи на GitHub

Перейди на GitHub.com и зарегистрируй новый бесплатный аккаунт.

Создание учётной записи на PythonAnywhere

Теперь нам потребуется создать бесплатный аккаунт уровня "Beginner" на PythonAnywhere.

Примечание: При выборе имени пользователя, помни что URL блога примет вид yourusername.pythonanywhere.com, так что остановись либо на своём нике, либо на имени, связанном с тематикой блога.

Начинай читать

Поздравляем, всё готово к работе! Если у тебя ещё осталось немного свободного времени до семинара, было бы полезно начать читать одну из первых глав: