Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dougthor42/sphinx_test

Playing around with Sphinx and trying to get docs built
https://github.com/dougthor42/sphinx_test

Last synced: 6 days ago
JSON representation

Playing around with Sphinx and trying to get docs built

Awesome Lists containing this project

README

        

# sphinx_test
Playing around with Sphinx and trying to get docs built

# Steps:

1. sphinx-quickstart

- path = .\\doc
- make sure to say yes to autodoc extension

2. add ``'sphinx.ext.napoleon'`` to extensions in doc\\conf.py
3. Change html_theme to ``'sphinx_rtd_theme'`` in doc\\conf.py
4. Add modules to sys.path in doc\\conf.py
4. Run sphinx-apidoc -f -o doc sphinx_test from trunk\\sphinx_test
5. ``cd doc``
6. ``make.bat html``
7. View html at trunk\\sphinx_test\\doc\\_build\html