Post

The Furo Sphinx Theme Looks Good with Small Documentations

For documentation, I prefer Sphinx over static site builders like Hugo and Jekyll, as I can

  • have one source for html, epub, and PDFs,
  • create docs from Jupyter Notebooks with Jupyterbook,
  • write in markdown with MyST, and
  • use book-like features such as index, glossary, bibliography, footnotes, and figure captions.

A disadvantage of Sphinx is that smaller documentations often look a bit empty with the most common themes for html.

Today, I stumbled across the Furo Sphinx theme. I like it’s minimal appearance and that it looks good even with small documentations.

I think I’ll give it a try.

This post is licensed under CC BY 4.0 by the author.