Posts in Sphinx
sphinxnotes-incrbuild: Enabling Sphinx incremental builds in CI/CD environment
- 2025-10-15
As we know, Sphinx supports incremental HTML build, and it works well locally. But for CI/CD, the environment is usually brand new, which causes Sphinx always to rebuild everything. The project wraps sphinx-build and ensures the environment is "incremental build"-able before running the real sphinx-build.
Implementing "nested inline markup" in reStructuredText and Sphinx
- 2024-01-14
Sphinx is a famous documentation generator used by a lot of Open Source communities. It uses reStructuredText (hereafter referred to rST) as markup language by default.