Лекции пишутся при помощи разметки reStructuredText. Собираются генератором документации Sphinx.
Файлы лекций имеют расширение .rst
и расположены в директории docs
.
GitHub умеет корректно отображать содержимое файлов, пример
https://github.com/ustu/lectures.www/blob/master/docs/6.www.sync/2.codding/1.mvc.rst.
Редактировать текст можно встроенным редактором GitHub или любимым редактором склонировав репозиторий локально.
Перейти на страницу для редактирования из лекций можно при помощи кнопки в верхнем правом углу "edit on github", пример http://lectureswww.readthedocs.io/6.www.sync/2.codding/1.mvc.html.
$ git submodule update --init --recursive
Для сборки необходимо установить пакетный менеджер Nix.
$ curl https://nixos.org/nix/install | sh
После установки Nix сборка осуществляется командой make:
$ make
$ firefox build/html/index.html