Документация - 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:

  1. djbook.ru – Частично переведённая на русский язык документация по Django https://djbook.ru/rel1.9/contents.html

  2. Официальная документация https://docs.djangoproject.com/en/2.0/