sphinx-book-theme
A clean book theme for scientific explanations and documentation with Sphinx
Decision gist · record as of 2026-08-14
Yes, if you are building Sphinx documentation and want a polished, interactive book-like appearance with Jupyter Notebook support. The theme is actively maintained for bug fixes, has low install friction, and carries a permissive license. However, be aware it is in maintenance mode—new features are unlikely, so evaluate whether its current capabilities meet your needs before adopting it.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later.
- Low install friction with a pure-Python wheel distribution.
- Active maintenance as of August 2026 with recent releases, though the project is in maintenance mode accepting bug fixes rather than new features.
License · maintenance · safety
permissive license (permissive) — Permissive license treatment allows use in most projects without significant restrictions, though the exact license terms are not specified in the fact sheet.
last release 2026-07-19 (26 days) · last repo commit 2026-08-03 · 492 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,277,556 downloads/mo, #4,122 on PyPI
Alternatives
Verify before relying
pip install sphinx-book-theme
Then in conf.py:
html_theme = "sphinx_book_theme"- Whether the theme works with all Sphinx extensions or has known incompatibilities.
- What specific configuration changes are needed when migrating from other themes.
- Performance characteristics with large documentation projects.
What it is and what it does
sphinx-book-theme is a Sphinx theme that transforms technical documentation into an interactive book-like experience. It uses Bootstrap 5 for styling and layout, with a flexible content design inspired by Edward Tufte's principles for presenting information clearly. The theme includes built-in support for rendering Jupyter Notebook cells (inputs, outputs, and interactive elements) and can integrate with BinderHub to provide live, executable code environments for documentation pages.
The theme is designed for scientific and technical documentation where readability and interactivity matter. It requires Sphinx and pydata-sphinx-theme as runtime dependencies and is currently in maintenance mode, meaning it accepts bug fixes but is not actively receiving new features. The project is actively maintained with recent releases.
Use it for
- Building interactive scientific documentation that includes executable Jupyter notebooks or code examples.
- Creating technical books or guides with a clean, professional appearance using Sphinx.
- Documenting Python projects with Jupyter-based tutorials that readers can run in the browser via BinderHub.
- Migrating from other Sphinx themes to a more visually appealing, book-like layout for existing documentation.
- Presenting mathematical or data-science content with Tufte-inspired layouts for clarity.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building Sphinx documentation and want a polished, interactive book-like appearance with Jupyter Notebook support.
The theme is actively maintained for bug fixes, has low install friction, and carries a permissive license. However, be aware it is in maintenance mode—new features are unlikely, so evaluate whether its current capabilities meet your needs before adopting it.
Install
sphinx-book-theme on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Active maintenance as of August 2026 with recent releases, though the project is in maintenance mode accepting bug fixes rather than new features. Depends on sphinx and pydata-sphinx-theme.
Requires Python 3.11 or later.
License in practice
Permissive license treatment allows use in most projects without significant restrictions, though the exact license terms are not specified in the fact sheet.
Quickstart
pip install sphinx-book-theme
Then in conf.py:
html_theme = "sphinx_book_theme"Verify before relying
- Whether the theme works with all Sphinx extensions or has known incompatibilities.
- What specific configuration changes are needed when migrating from other themes.
- Performance characteristics with large documentation projects.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagessphinxpydata-sphinx-theme |
| Maintenance | Actively maintained 26 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,277,556 / month, #4,122 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaFramework :: SphinxFramework :: Sphinx :: ThemeLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: sphinx_book_theme-1.4.0-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 › “interactive book theme sphinx”
- sphinx-book-themeA Sphinx theme that renders documentation as an interactive book with…
- sphinx-jupyterbook-latexA Sphinx extension that adds LaTeX output infrastructure for Jupyter…
- shibuyaShibuya is a Sphinx documentation theme that renders HTML…
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-bootstrap-theme · sphinx-jupyterbook-latex · sphinx-rtd-dark-mode · shibuya · pydata-sphinx-theme · Pallets-Sphinx-Themes · furo · sphinx_design · sphinx-rtd-theme · sphinx-panels