Документация - kotovenc/web1.0 GitHub Wiki
1. Установка программного обеспечения для работы с Django
Операционная система: Ubuntu 16.04 LTS или любой другой дистрибутив на основе Ubuntu или Debian. Важно, чтобы был менеджер пакетов apt. Предполагается, что ОС у вас уже установлена и вы знаете пароль суперпользователя.
Перед установкой рекомендуется сделать backup-системы на всякий случай:)
Распакуйте install_django.tar.gz
Откройте терминал (Ctrl+Alt+T)
Запустите скрипт install и следуйте инструкциям:
$ ./install
Скрипт представляет из себя перечень команд, необходимых для установки всего необходимого ПО. В пункте 1.1 перечислены последовательно все команды, выполняемые скриптом. Ознакомьтесь с ними.
1.1. Установка необходимых пакетов и библиотек
Первым делом необходимо обновить пакеты (может занять некоторое время):
$ sudo apt-get update
$ sudo apt-get upgrade
Убедимся, что у вас стоит необходимая версия Python3:
$ python3 –version
Python 3.5.2
Далее следует установить pip – систему управления пакетами, написанными на Python.
$ sudo apt-get install python-pip
После установки pip установим MySQL-Server
$ sudo apt-get install mysql-server
При установке у вас попросят пароль пользователя root. Введите LivY
$ sudo apt-get install mysql-client
Установим необходимую библиотеку для работы с моделями в Django:
$ sudo apt-get install libmysqlclient-dev
На этом работа скрипта завершена. Поздравляю!
Вы можете, также, установить себе графический клиент MySQL-Workbenсh (необязательно):
$ sudo apt-get install mysql-workbench
1.2. Установка пакетов Python с помощью pip
Сперва необходимо установить создать виртуальное окружение (ВО) для вашего проекта. К примеру, вашему проекту нужен отличный от установленного Python или какие-либо библиотеки отличных версий, вы можете создать общее окружение для нескольких проектов или по одному собственному для каждого проекта. Тем самым вы сможете устанавливать, изменять и удалять пакеты, и это не повлияет на другие ваши проекты или системное окружение.
Установка:
$ pip install virtualenv
Создание окружения:
$ virtualenv Django
Запуск ВО:
$ source Django/bin/activate
Чтобы выйти из ВО:
$ deactivate
Запомните: важно устанавливать все необходимые для Django пакеты и библиотеки в ВО. Разработка ведётся только в ВО! Необходимо снова обновить пакеты, но уже в виртуальном окружении
$ sudo apt-get update
Установите git в ВО:
$ sudo apt-get install git
Установка всех пакетов необходимых для проекта будет произведена автоматически после запуска команды:
$ pip install –r requirements.txt
Примечание: файл requirements.txt лежал в архиве install_django.tat.gz. В нём находятся названия всех необходимых python-пакетов (Django и т.д). Вам необходимо переместить его в директорию с виртуальным окружением.
$ mv <полный путь к файлу> .
Создадим тестовый проект:
$ django-admin startproject <имя-проекта>
Перейдём в директорию проекта и запустим сервер для разработки:
$ python manage.py runserver
Она должна выводить примерно следующее:
Performing system checks...
System check identified no issues (0 silenced).
You have 13 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions. Run 'python manage.py migrate' to apply them.
June 29, 2018 - 22:37:40 Django version 1.11.13, using settings 'Firetag.settings' Starting development server at http://127.0.0.1:8000/ Quit the server with CONTROL-C.
Откройте браузер и введите в адресную строку URL localhost'а, указанный сервером. Если у вас загрузилась страница без ошибки с кодом 404, то поздравляю Вас! Вы поставили всё необходимое ПО и запустили сервер.
После установки рекомендуется сделать ещё раз backup-системы.
Документация по Django:
-
djbook.ru – Частично переведённая на русский язык документация по Django https://djbook.ru/rel1.9/contents.html
-
Официальная документация https://docs.djangoproject.com/en/2.0/