Sphinx Documentation

The simplest way to generate sphinx documentation is to use py-sphinx package from Alpine linux:

containers:

  docs:
    setup:
    - !Alpine v3.2
    - !Install [alpine-base, py-sphinx, make]
    # If you require additional packages to build docs uncomment this
    # - !Py2Requirements docs/requirements.txt

commands:

  doc: !Command
    description: Build documentation
    container: docs
    run: [make, html]
    work-dir: docs
    epilog: |
      --------------------------------------------------------
      Documentation is built under docs/_build/html/index.html

To start documentation from scratch (if you had no sphinx docs before), run the following once (and answer the questions):

vagga _run docs sphinx-quickstart target_doc_directory