TechWriter at work blog
Living and writing documentation at Documatt, small team of programmers that write documentation too.
Posts tagged sphinx
Sphinx Errors
- Sep 04, 2023
List of common Sphinx, Docutils and reStructuredText warnings and errors. Each issue is well explained, illustrated by an example, and offers solution.
Debugging Sphinx extensions
- May 26, 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.
Best Sphinx conf.py tips
- May 13, 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.
CSS to remove document title from Sphinx local ToC
- May 07, 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.
How to modify Sphinx theme?
- Aug 13, 2020
Tech writers should write. Delivering documentation in a visually appealing manner is almost the same important as the content itself, however. Sphinx themes are “skins” that define look & feel of documentation when outputted to HTML format. In this post, you will learn how to customize existing or create a new theme from scratch.
Sphinx Themes
- Aug 12, 2020
Sphinx theme is skin that changes the appearance of HTML version of the documentation. It contains HTML templates, CSS stylesheets, and static files like images, favicon, fonts, etc.
How to add a sitemap to the Sphinx project?
- Jul 02, 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.