Posts tagged sphinx
- 26 April 2021
Developing extensions for Sphinx documentation projects can easily grow into a big Python project. Debugging with
print() quickly becomes a no-go. Let’s have a look how to debug Sphinx extension of any size.
- 13 April 2021
Over the years writing documentation in Sphinx, I found I do the same tweaks in every Sphinx project’s
conf.py again and again. Here are the best ones.
- 07 April 2021
This week, I’m working on Documatt Sphinx Theme, a theme used for example in this blog. One of the longest postponed feature is displaying a local table of contents (ToC) in the right sidebar. By default, Sphinx displays a current document title in the local ToC, so let’s fix it.
- 02 July 2020
Sitemap is essential part of making your website more visible for search engines. It is usually represented by the
sitemap.xml file and lists URLs of all website pages, translations of pages in alternative languages, etc. sphinx-sitemap extension can easily generate sitemap for your Sphinx documentation project.