pip install -U recommonmark sphinx sphinx_rtd_theme sphinx_markdown_tables
rm -rf source && sphinx-apidoc -o source/ ../
Write or modify each documentation page as a markdown file.
Include the markdown file in index.rst
toctree
.
You may modify the landing page index.rst
itself in reStructuredText format.
make html
You may ignore the consistency warning that README.md is not included in toctree. README.md is this file, the instruction to generate documentation website.
The website is generated in _build/html