Примечание: если ты используешь Chromebook, пропусти эту главу, но выполни инструкции по настройке для Chromebook

Примечание: если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!

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

Отдельные части этой главы основаны на учебном пособии 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 — твоё имя пользователя).

Примечание: Если ты работаешь в Windows, удостоверься, что в названии директории нет специальных символов или символов с диакритическими знаками; если в твоём имени пользователя есть такие символы, выбери другую директорию, например, C:\djangogirls .

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

$ mkdir djangogirls $ cd djangogirls

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

$ python3 -m venv myvenv

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

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

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

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

$ python3 -m venv myvenv

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

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

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

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

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

Работаем с virtualenv

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

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

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

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

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

$ source myvenv/bin/activate

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

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

$ . myvenv/bin/activate

Ты поймёшь, что virtualenv запущено, когда увидишь префикс (myvenv) в начале приглашения командной строки.

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

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

Установка Django

После запуска virtualenv ты можешь установить Django.

Перед этим мы должны удостовериться, что у тебя установлена последняя версия pip — программы, которую мы используем для установки Django.

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

Установка библиотек через указание требований

Файл с требованиями (requirements) хранит список зависимостей, которые нужно установить с помощью pip install:

Для начала создай файл requirements.txt внутри директории djangogirls/ , используя текстовый редактор, который ты установила ранее. Просто создай в редакторе новый файл, а затем сохрани его под именем requirements.txt в директории djangogirls/ . После этого твоя директория будет выглядеть так:

Djangogirls └───requirements.txt

В файл djangogirls/requirements.txt нужно добавить такой текст:

djangogirls/requirements.txt

Django~=2.0.6

Теперь выполни команду pip install -r requirements.txt , чтобы установить Django.

(myvenv) ~$ pip install -r requirements.txt Collecting Django~=2.0.6 (from -r requirements.txt (line 1)) Downloading Django-2.0.6-py3-none-any.whl (7.1MB) Installing collected packages: Django Successfully installed Django-2.0.6

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

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

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

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

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

1. Установка и настройка Python.

Для установки Python, его, ясно дело, надо для начала

• скачать с http://python.org/download/, далее следовать указаниям установщика.

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

• Итак, перемнную PATH можно найти (для Win Vista) через Kомпьютер >> Свойства >>Дополнительные параметры системы >> Переменные среды, в окошке «Системные перемнные» найти переменную PATH и, не заменить, а ДОБАВИТЬ(!) к этой переменной значение «C:\Python25;C:\Python25\Scripts;C:\Python25\lib\site-packages\django\bin»,

где «C:\Python25» - корневой каталог установленного Python.

2. Установка Django.

Здесь, опять же, сперва надо

• скачать Django с http://www.djangoproject.com/download/ одним из представленных на странице способов.

• Если было принято решение качать официальную версию (первым способом), то, распаковав архив, надо в коммандной строке перейти в корневой каталог распакованного Django, затем выполнить команду «setup.py install» (в случае, если переменная окружения из первого шага не была установлена, тогда «python setup.py install»).

Необходимый инструментарий развёрнут, теперь дело за средой разработки.

3. Установка Eclipse.

Здесь вообще всё просто, скачать Eclipse можно с http://www.eclipse.org/downloads, установка не составит большого труда.

4. Установка и настройка PyDev.

Имея на руках установленную Eclipse можем установить плагин к ней для разработки на Python - имя ему PyDev.

• Запустите Eclipse и в меню выберите Help >> Software Updates >> Find and Install… (Справка >> Обновление программ >> Найти и установить...).
• 
  Выберите: Search for new features to install (Поиск новых комплектов для установки)
  Нажмите кнопку и введите следующий сетевой адрес: http://pydev.sourceforge.net/updates/.
• 
  Выберите только что добавленный сайт, выставив напротив него галочку, и нажмите кнопку .
• 
  Выберите PyDev расширение в списке комплектов для установки и нажмите кнопку . Подождите пока выбранные компоненты загрузятся и установятся в систему.

Теперь надо бы настроить PyDev.

• Выберите в меню Window >> Preferences (Окно >> Параметры...) далее в дереве слева укажите PyDev>> Interpreter - Python.
• 
  Вверху в панели Python interpreters нажмите и укажите полный путь к установленному Python (python.exe или python для Linux).

• Далее в панели System PYTHONPATH нажмите и укажите путь к корневой папке Django.

Ну и «OK» нажать не забудьте.

5. Создание репозитория (на хостинге проектов google).

Для этого, всего на всего, нужно заполнить анкету на странице http://code.google.com/hosting/createProject, будучи залогиненым с помощью аккаунта Gmail.

6. Установка и настройка SubVersion.

Для работы с SubVersion, или системой контроля версий, для Eclipse существует плагин SubEclipse.Чтобы его установить

• в меню Eclipse выберите Help >> Software Updates >> Find and Install… (Справка >> Обновление программ >> Найти и установить...).
• 
  Выберите: Search for new features to install (Поиск новых комплектов для установки).
• 
  Нажмите кнопку и введите следующий сетевой адрес: http://subclipse.tigris.org/update_1.4.x

Теперь систему надо настроить на репозиторий, созданный на пятом шаге.Для этого,

• выбрав перспективу SubEclipse (Window >> Open perspective >> Other… >> SVN Repository Exploring),

• в панели SVN Repositories в контекстном меню выбрать New… >> Repositoty Location… и в поле URL вставить адрес репозитория.

Адрес репозитория виден на странице вашего проекта на хостинге проектов Google, во вкладке Source. Это строка вида «https://<имя проекта>.googlecode.com/svn/trunk/».

• Далее система спросит логин и пароль.

Логином здесь является имя учётной записи в Gmail, а пароль вам нужно будет сгенерировать, перейдя по ссылке «When prompted, enter your generated googlecode.com password.». Она находится на той же странице вашего проекта, в той же вкладке Source.

Ну вот и всё.

В инструкции использовался материал статьи

pip install Django==2.1.7

Option 2: Get the release candidate for 2.2

pip install --pre django

Option 3: Get the latest development version

The latest and greatest Django version is the one that’s in our Git repository (our revision-control system). This is only for experienced users who want to try incoming changes and help identify bugs before an official release. Get it using this shell command, which requires Git :

git clone https://github.com/django/django.git

Additional information

For the impatient:

• Latest release:
  Checksums:
  Release notes:
• Preview release:
  Checksums:
  Release notes:

Which version is better?

We improve Django almost every day and are pretty good about keeping the code stable. Thus, using the latest development code is a safe and easy way to get access to new features as they’re added. If you choose to follow the development version, keep in mind that there will occasionally be backwards-incompatible changes. You’ll want to pay close attention to the commits by watching Django on GitHub or subscribing to django-updates .

If you’re just looking for a stable deployment target and don’t mind waiting for the next release, you’ll want to stick with the latest official release (which will always include detailed notes on any changes you’ll need to make while upgrading).

Previous releases

• Django 2.0.13:
  Checksums:
  Release notes:
• Django 1.11.20 (LTS):
  Checksums:
  Release notes: