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