5.1.3.3. Read The Docs - sphinx_rtd_theme_single

The sphinx_rtd_theme provides a local them for ReadTheDocs style. The singlehtml variant is adapted for correct table of contents.

../../../_images/rtd_singlehtml1.png

Figure: Theme ‘sphinx_rtd_theme’ - singlehtml

configuration

The current example implementation contains the files within the default path:

setupddocx/configurations/sphinx/sphinx_rtd_theme_single

file

remark

docsrc/conf.py

adds configuration variables

docsrc/index.rst

addapts landing page for TOC

docsrc/_static/custom.css

sets some custom colors and sizes

docsrc/_static/favicon.ico

provides a demo favicon, requires ICO

docsrc/_static/logo.png

provides a demo logo, requires PNG

call

The call creates a html document within the local directory doc

python setup.py  -q  \
   build_docx  \
      --apiref  \
      --doctype=htmlsingle  \
      --conf-dir=setupdocx/configurations/sphinx_rtd_theme_single/ \
      --docname=setupdocx-rtd-single \
   install_docx \
      --dist-dir=doc \
      --docname=setupdocx-rtd-single

# cut-and-paste for execution
# for readability split acros multiple lines