I’ve been using Sphinx for a few weeks now, and I like it. I’m not sure yet about writing a blog in it, but it can’t be worse than Jekyll.

I’m now at the point where I want it to look a certain way, so here’s what I’m reading about modifying and controlling Sphinx. I’ll get it into shape with conclusions in a bit.

matplotlib: sampledoc

reStructuredText: Including an External Document Fragment

Read The Docs

Sphinx: HTML theming support

Write The Docs: Sphinx Themes

snide/sphinx_rtd_theme - the source for the Read The Docs Sphinx theme.

Read the Docs Theme

StackOverflow: Customize sphinxdoc theme - simple example of Sphinx theming.

StackOverflow: Some good Sphinx customization examples? - useful compendium of Sphinx theming links.

coordt/ADCtheme - a Sphinx theme that mimics the look of Apple Developer Connection documentation.

pallets/flask-sphinx-themes - source for Flask Sphinx Themes

http://loose-bits.com/2012/11/19/sphinx-bootstrap-theme-updates.html

http://ryan-roemer.github.io/sphinx-bootstrap-theme/README.html

http://matplotlib.org/

http://matplotlib.org/devel/documenting_mpl.html#dynamically-generated-figures

http://matplotlib.org/devel/documenting_mpl.html#inheritance-diagrams

https://pypi.python.org/pypi/sphinx-bootstrap-theme/

https://pythonhosted.org/sphinxjp.themes.basicstrap/options.html