Документация написана при помощи языка разметки reStructuredText и генератора Sphinx. Sphinx — это генератор документации, который преобразует файлы в формате reStructuredText в HTML website и другие форматы (PDF, EPub и man).

• https://ru.wikipedia.org/wiki/Sphinx_(генератор_документации)
• Документация на русском

Клонирование репозитария

$ git clone git@github.com:ustu/lectures.www.git
$ cd lectures.www

Инициализация подмодулей (сами лекции)

$ git submodule update --init --recursive --remote

Установка

$ pip install -r _lectures/requirements.txt

или через nix:

$ cd _lectures
$ nix-shell

.
├── docs <----- Файлы настроек для лекций в формате RST
├── vagrant <----- Docker контейнер для запуска примеров
├── make.bat
├── Makefile
├── README.rst
├── requirements.txt
├── rstlint.py
├── CONTRIBUTING.rst
├── test.sh <----- Всякие линтеры и чекеры
└── Vagrantfile <----- Vagrant для автоматизации запуска
 Docker контейнеров

Для Unix like

$ LECTURES=www make html

В Docker

$ LECTURES=www vagrant up --provider=docker

$ LECTURES=www vagrant reload

Смотри CONTRIBUTING.rst