sphinx-multitoc-numbering
Supporting continuous HTML section numbering
Decision gist · record as of 2026-08-14
Yes, if your Sphinx version is compatible with the 0.1.3 release from 2021-03-15. The extension solves a real problem with minimal install friction and permissive licensing. However, verify compatibility with your Sphinx version first, as the abandoned status means no updates for newer releases. If you encounter issues with current Sphinx versions, check for community forks or consider whether the numbering problem can be solved another way.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires an existing Sphinx documentation project with conf.py.
- Installation is straightforward with no complex dependencies beyond Sphinx itself.
- However, the package has been abandoned since its last release on 2021-03-15, so it will not receive bug fixes or compatibility updates for newer Sphinx versions.
License · maintenance · safety
MIT (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.
last release 2021-03-15 (1978 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 231,062 downloads/mo, #9,097 on PyPI
Alternatives
Verify before relying
pip install sphinx-multitoc-numbering
Then in conf.py:
extensions = ["sphinx_multitoc_numbering"]- Compatibility with Sphinx versions released after 2021-03-15
- Whether the extension works with current stable Sphinx releases
- Active maintenance status or community forks that may have continued development
What it is and what it does
sphinx-multitoc-numbering is a Sphinx extension that solves a specific documentation problem: when you split a large document into multiple table-of-contents (toctree) structures—common in jupyter-book projects with separate parts or sections—the default Sphinx behavior resets section numbering at each toctree boundary. This extension maintains continuous numbering across those boundaries, so chapters and sections are numbered sequentially throughout the entire document.
You install it as a standard Sphinx extension by adding it to the extensions list in conf.py. It has only one runtime dependency: Sphinx itself. The extension integrates directly into Sphinx's HTML generation pipeline and requires no additional configuration beyond activation. However, the package has not been updated since 2021-03-15, which means it may have compatibility issues with recent Sphinx releases and will not receive maintenance fixes.
Use it for
- Multi-part jupyter-book projects where you want chapters numbered continuously across separate parts instead of restarting at each part.
- Large Sphinx documentation split into multiple toctrees where section numbers should flow sequentially rather than reset.
- Academic or technical documents with chapters organized across different toctree structures that need unified numbering.
- Documentation projects that need Sphinx to maintain continuous numbering across organizational boundaries.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if your Sphinx version is compatible with the 0.1.3 release from 2021-03-15.
The extension solves a real problem with minimal install friction and permissive licensing. However, verify compatibility with your Sphinx version first, as the abandoned status means no updates for newer releases. If you encounter issues with current Sphinx versions, check for community forks or consider whether the numbering problem can be solved another way.
Install
sphinx-multitoc-numbering on PyPI
Before you install
Installation is straightforward with no complex dependencies beyond Sphinx itself. However, the package has been abandoned since its last release on 2021-03-15, so it will not receive bug fixes or compatibility updates for newer Sphinx versions.
Requires an existing Sphinx documentation project with conf.py.
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.
Quickstart
pip install sphinx-multitoc-numbering
Then in conf.py:
extensions = ["sphinx_multitoc_numbering"]Verify before relying
- Compatibility with Sphinx versions released after 2021-03-15
- Whether the extension works with current stable Sphinx releases
- Active maintenance status or community forks that may have continued development
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagesphinx |
| Maintenance | Abandoned 1,978 days since the last release |
| First released | |
| Downloads | 231,062 / month, #9,097 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: sphinx_multitoc_numbering-0.1.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “sphinx section numbering across tocs”
- sphinx-multitoc-numberingA Sphinx extension that maintains continuous section numbering across…
- sphinx_external_tocA Sphinx extension that defines documentation site-maps in a single…
- sphinx-hoverxrefSphinx extension that displays tooltips with linked section content…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sphinx packages
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
A Sphinx extension that converts documentation source files into QtHelp format, enabling integration with Qt-based help systems and documentation viewers.
However, be aware that maintenance is dormant—if you rely on it long-term, monitor Sphinx compatibility and consider whether QtHelp remains the right format for your…
See also sphinx_external_toc · sphinx-remove-toctrees · sphinx-tabs · myst-nb · sphinx_design · myst-parser · autoclasstoc · sphinx-togglebutton · sphinx-panels · sphinx-sitemap