Подготовка рабочего окружения

Предупреждение

Раздел в разработке.

Подготовка рабочего окружения

1. Командная строка

Ряд шагов по подготовке рабочего окружения требует использования командной строки.

Debian / Ubuntu / Linux Mint

В операционных системах Debian, Ubuntu и Linux Mint доступ к командной строке обычно можно получить, найдя и запустив приложение «Терминал».

В большинстве операционных систем семейства GNU/Linux терминал так же может быть запущен с помощью сочетания клавиш ctrl + alt + t.

2. Python

В вашей операционной системе должен быть установлен интерпретатор языка программирования Python 3.7 или выше. Проверить, установлен ли интерпретатор нужной версии можно в командной строке:

python --version
python3 --version

Debian / Ubuntu / Linux Mint

Как правило, в операционных системах семейства GNU/Linux интерпретатор Python уже установлен.

Если в системе есть интерпретатор Python больше версии 3.0 и меньше 3.7, то проще и безопасне установить интерпретатор Python 3.7 или новее с помощью pyenv.

3. Установка системы контроля версий Git

В вашей операционной системе должна быть установлена система контроля версий Git.

Debian / Ubuntu / Linux Mint

Установите пакет git:

apt install git

4. Установка набора хуков git-flow

Debian / Ubuntu / Linux Mint

Установите пакет git-flow:

apt install git-flow

5. Установка менеджера пакетов pip

Debian / Ubuntu / Linux Mint

apt install python3-pip

Windows

Не требуется. Должен был установиться вместе с интерпретатором Python.

6. Установка конвертора изображений imagemagick

Для конвертирования векторных изображений SVG в растровые изображения PNG, Вам необходимо установить imagemagick.

Debian / Ubuntu / Linux Mint

apt install imagemagick

Windows

Сборки imagemagick для операционных систем семейства Windows доступны по ссылке https://imagemagick.org/script/download.php#windows

7. Установка LaTeX

Для сборок в формате PDF на основе LaTeX, Вам необходимо установить библиотеки LaTeX.

Debian / Ubuntu / Linux Mint

apt install texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra texlive-lang-cyrillic latexmk

Windows

Предупреждение

Инструкции по установке LaTex в операционной системе Windows возможно будут добавлены позднее.

8. Клонирование проекта

Debian / Ubuntu / Linux Mint

Необходимо склонировать репозиторий в удобную для Вас директорию (папку).

Наиболее универсальный способ, склонировать по протоколу HTTPS:

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

Если владельцами настроен доступ по SSH ключу, лучше склонировать по протоколу SSH:

git clone git@github.com:csph/csph.git

9. Инициализация хуков git-flow

Перейдите в директорию проекта:

cd csph

Инициализируйте git-flow:

git flow init

Ответьте положительно на все вопросы, нажимая Enter.

10. Установка модуля venv стандартной библиотеки Python

Debian / Ubuntu / Linux Mint

apt install python3-venv

Windows

Не требуется. Должен был установиться вместе с интерпретатором Python.

11. Создание виртуального окружения Python

Debian / Ubuntu / Linux Mint

python3 -m venv .venv

Windows

python -m venv .venv

12. Активация виртуального окружения Python

Debian / Ubuntu / Linux Mint

source .venv/bin/activate

Windows

.venv\Scripts\activate.bat

13. Установка программных зависимостей в виртуальное окружение Python

pip install -r requirements.txt