Лекции пишутся при помощи разметки reStructuredText <https://ru.wikipedia.org/wiki/ReStructuredText>
. Собираются генератором
документации `Sphinx
<https://ru.wikipedia.org/wiki/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.
.. code-block:: bash
$ git submodule update --init --recursive
Для сборки необходимо установить пакетный менеджер Nix <https://nixos.org/nix/>
_.
.. code-block:: bash
$ curl https://nixos.org/nix/install | sh
После установки Nix
сборка осуществляется командой make
:
.. code-block:: bash
$ make
.. code-block:: bash
$ firefox build/html/index.html