diff options
author | Todd Leonhardt <todd.leonhardt@gmail.com> | 2018-07-31 07:48:46 -0700 |
---|---|---|
committer | Todd Leonhardt <todd.leonhardt@gmail.com> | 2018-07-31 07:48:46 -0700 |
commit | 6cff4b2cb70ba41d6b90a39c829043efa195eec9 (patch) | |
tree | aaf8658dd9ac63e2ba79046285016b969059386a | |
parent | bc559df2afcc51d1804e5d068d7e2c57bc4f72af (diff) | |
download | cmd2-git-6cff4b2cb70ba41d6b90a39c829043efa195eec9.tar.gz |
Removed non-working Module Index link from the main Sphinx docs page
Also:
* Improved Sphinx build options in Makefile and via invoke by adding the following options:
* -n : nit-picky mode, warn about all missing references
* -v : increase verbosity (can be repeated)
* -W : turn warnings into errors
* -T : show full traceback on exception
-rw-r--r-- | docs/Makefile | 2 | ||||
-rw-r--r-- | docs/index.rst | 7 | ||||
-rw-r--r-- | tasks.py | 3 |
3 files changed, 5 insertions, 7 deletions
diff --git a/docs/Makefile b/docs/Makefile index 76bdbe20..433ddd3c 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -2,7 +2,7 @@ # # You can set these variables from the command line. -SPHINXOPTS = +SPHINXOPTS = -nvWT SPHINXBUILD = sphinx-build PAPER = BUILDDIR = _build diff --git a/docs/index.rst b/docs/index.rst index d3b2adfe..31bb4771 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -75,10 +75,7 @@ Compatibility Tested and working with Python 3.4+ on Windows, macOS, and Linux. -Indices and tables -================== +Index +===== * :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - @@ -89,11 +89,12 @@ namespace_clean.add_task(tox_clean, 'tox') ##### DOCS_SRCDIR = 'docs' DOCS_BUILDDIR = os.path.join('docs', '_build') +SPHINX_OPTS = '-nvWT' # Be nitpicky, verbose, and treat warnings as errors @invoke.task() def docs(context, builder='html'): "Build documentation using sphinx" - cmdline = 'python -msphinx -M {} {} {}'.format(builder, DOCS_SRCDIR, DOCS_BUILDDIR) + cmdline = 'python -msphinx -M {} {} {} {}'.format(builder, DOCS_SRCDIR, DOCS_BUILDDIR, SPHINX_OPTS) context.run(cmdline) namespace.add_task(docs) |