No description, website, or topics provided.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Technical Contributor Guide

This repository contains documentation for Aviatrix written using the reStructuredText format.

Publishing

HTML documentation is generated using Sphinx. Shortly after a commit is pushed to this repository, the latest source is turned into HTML files and published to docs.aviatrix.com.

How To Generate

If you'd like to generate the documentation yourself, follow the steps outlined below.

Install Sphinx

  1. Install the latest version of Sphinx

  2. Install sphinx-rtd-theme

    pip install sphinx-rtd-theme

  3. Install sphinxcontrib-disqus

    pip install sphinxcontrib-disqus

Build output with Sphinx

To generate the output, use the sphinx-build command. It has a lot of options; but, the simple case of generating HTML output looks like:

sphinx-build -b html . ./output