NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4678 most downloaded on PyPI
A clean book theme for scientific explanations and documentation with Sphinx
Last release 2 months ago
19 Jul 2026
Release timing varies
gaps range from 8 days to 13 months
Some releases are documented
notes for 31 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
79 releases · first in 2020
One column per quarter.
<!-- Release notes generated using configuration in .github/release.yml at v1.4.0 -->
<!-- Release notes generated using configuration in .github/release.yml at v1.4.0 -->
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v1.3.0...v1.4.0
<!-- Release notes generated using configuration in .github/release.yml at v1.3.0 -->
<!-- Release notes generated using configuration in .github/release.yml at v1.3.0 -->
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v1.2.0...v1.3.0
Nothing published for this version
Ignore PendingDeprecationWarning about parser_name deprecation with Docutils 0.22 by @mitya57 in https://github.com/executablebooks/sphinx-book-theme/…
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v1.1.4...v1.2
ENH: make the generated documentation more reproducible #883 (@mitya57)
html_source_suffix to html_sourcelink_suffix #859 (@Snoopy1866)(GitHub contributors page for this release)
@agoose77 | @askras | @bsipocz | @choldgraf | @dependabot | @dylanh724 | @kloczek | @mitya57 | @nilsleh | @pre-commit-ci | @Snoopy1866 | @stevepiercy | @welcome
ENH: bump version for release :rocket: #843 (@agoose77)
.bd-sizebar-secondary and .secondary-toggle breakpoint #809 (@sinsong)findall instead of traverse #820 (@agoose77)(GitHub contributors page for this release)
@aawadaptix | @afeld | @agoose77 | @choldgraf | @dependabot | @LecrisUT | @sinsong | @welcome
ENH: bump version #818 (@agoose77)
ENH: bump version for 1.1.1 #815 (@agoose77)
(GitHub contributors page for this release)
@agoose77 | @choldgraf | @dependabot | @ghisvail | @pre-commit-ci | @welcome
DOCS: update CHANGELOG for deprecation #790 (@agoose77)
This release brings in the latest PyData Sphinx Theme, adds major improvements to accessibility, improves the search UX, and fixes a lot of bugs 🐛.
_static in css_files #794 (@agoose77)datetime as kitchen-sink API module #787 (@agoose77)navbar_max_depth and collapse_navbar #605 (@gilbertbw)(GitHub contributors page for this release)
@AakashGfude | @adam-grant-hendry | @agoose77 | @akhmerov | @Alex-JG3 | @avivajpeyi | @bradbell | @callezenwaka | @CalMacCQ | @choldgraf | @dependabot | @Eutropios | @flying-sheep | @gilbertbw | @Gouvernathor | @jackshiwl | @jayaddison | @Kladdy | @LecrisUT | @Maetveis | @ogrisel | @pre-commit-ci | @Sdaher21 | @stevepiercy | @welcome
ENH: prepare for 1.1.0rc2 #793 (@agoose77)
DOCS: update CHANGELOG for deprecation #790 (@agoose77)
datetime as kitchen-sink API module #787 (@agoose77)(GitHub contributors page for this release)
@agoose77 | @CalMacCQ | @choldgraf | @dependabot | @jackshiwl | @pre-commit-ci | @welcome
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/executablebooks/sphinx-book-theme/pull/705
navbar_max_depth and collapse_navbar by @gilbertbw in https://github.com/executablebooks/sphinx-book-theme/pull/605Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v1.0.1...v1.1.0rc1
This minor brings compatibility with pydata-sphinx-theme v0.13.3 and greater.
This is a minor release supporting pydata>=0.13.3, with a few import changes from pydata.
This is a major release that brings in the latest PyData Sphinx Theme, Bootstrap 5, and updates many features.
This is a major release that brings in the latest PyData Sphinx Theme, Bootstrap 5, and updates many features.
See the Sphinx Book Theme changelog for details.
@12rambau (activity) | @AakashGfude (activity) | @akhmerov (activity) | @AllenDowney (activity) | @avivajpeyi (activity) | @bmorris3 (activity) | @choldgraf (activity) | @chrisjsewell (activity) | @consideRatio (activity) | @feanil (activity) | @fm75 (activity) | @ghutchis (activity) | @guillaume-haerinck (activity) | @haklc (activity) | @iasbusi (activity) | @ivirshup (activity) | @James11222 (activity) | @kloczek (activity) | @ksuess (activity) | @martinfleis (activity) | @mathbunnyru (activity) | @mcjulian1107 (activity) | @melund (activity) | @mmcky (activity) | @paugier (activity) | @PhilipVinc (activity) | @pradyunsg (activity) | @rkdarst (activity) | @rossbar (activity) | @scmmmh (activity) | @sieler (activity) | @SilverRainZ (activity) | @stevepiercy (activity) | @trallard (activity) | @whyjz (activity) | @yuvipanda (activity) | @ZedThree (activity)
This is a major release that brings in the latest PyData Sphinx Theme and a number of new features with it.
It also overhauls and standardizes the HTML structure of the theme.
Because of this large refactor, we are bumping the major version to 1.0.
Note that this doesn't imply any new long-term support or stability, we will continue to try not to make major breaking changes but will continue incrementing major versions if we must do so.
v0.13. See the PyData Sphinx Theme v0.13 release notes for details.Long sidebar entries now wrap. If you'd like to un-do this and revert to old behavior (where they are cut off if too long), then use the following CSS rule in your custom Sphinx CSS:
.bd-sidebar-primary a {
word-wrap: unset;
}
single_page is deprecated. If you'd like to restore the old behavior (hiding sidebars), then use the following configuration in your conf.py:
html_sidebars = {
"**": []
}
(GitHub contributors page for this release)
@12rambau (activity) | @AakashGfude (activity) | @akhmerov (activity) | @AllenDowney (activity) | @avivajpeyi (activity) | @bmorris3 (activity) | @choldgraf (activity) | @chrisjsewell (activity) | @consideRatio (activity) | @dependabot (activity) | @feanil (activity) | @fm75 (activity) | @ghutchis (activity) | @guillaume-haerinck (activity) | @haklc (activity) | @iasbusi (activity) | @ivirshup (activity) | @James11222 (activity) | @kloczek (activity) | @ksuess (activity) | @martinfleis (activity) | @mathbunnyru (activity) | @mcjulian1107 (activity) | @melund (activity) | @mmcky (activity) | @paugier (activity) | @PhilipVinc (activity) | @pradyunsg (activity) | @pre-commit-ci (activity) | @rkdarst (activity) | @rossbar (activity) | @scmmmh (activity) | @sieler (activity) | @SilverRainZ (activity) | @stevepiercy (activity) | @trallard (activity) | @whyjz (activity) | @yuvipanda (activity) | @ZedThree (activity)
See https://github.com/executablebooks/sphinx-book-theme/releases/tag/v1.0.0rc1 for release notes
See https://github.com/executablebooks/sphinx-book-theme/releases/tag/v1.0.0rc1 for release notes
See https://github.com/executablebooks/sphinx-book-theme/releases/tag/v1.0.0rc1 for release notes
See https://github.com/executablebooks/sphinx-book-theme/releases/tag/v1.0.0rc1 for release notes
A release candidate for v1.0 of this theme. We're making it 1.0 because there are several major breaking changes!
A release candidate for v1.0 of this theme. We're making it 1.0 because there are several major breaking changes!
pip install -U --pre sphinx-book-theme
Leave comments in this issue:
(GitHub contributors page for this release)
@12rambau, @AakashGfude, @AllenDowney, @avivajpeyi, @bmorris3, @choldgraf, @chrisjsewell, @consideRatio, @dependabot, @feanil, @ghutchis, @guillaume, @haklc, @ivirshup, @James11222, @ksuess, @mathbunnyru, @melund, @mmcky, @pradyunsg, @pre, @rkdarst, @rossbar, @scmmmh, @sieler, @SilverRainZ, @stevepiercy, @welcome, @whyjz, @yuvipanda, @ZedThree
This is a pre-release for an upcoming major version change of this theme.
This is a pre-release for an upcoming major version change of this theme.
Style edits for last-child zero-margin on dd's #586 (@benjaoming)
_readthedocs.scss as per guidelines #579 (@pradyunsg)templates_path in config was overriding any value append to templates_path in this package. #566 (@AakashGfude)Two patch releases fixed two bugs for figure content in the margin.
Two patch releases fixed two bugs for figure content in the margin.
A patch release to fix a few UI bugs.
A patch release to fix a few UI bugs.
This is a significant change in the HTML and CSS of the site, with the goal of making it more standardized and robust. There are several design tweaks
This is a significant change in the HTML and CSS of the site, with the goal of making it more standardized and robust. There are several design tweaks that have been made. Here is a short overview:
sticky and other CSS behaviors more dependable.See the PRs below for where most of these changes occurred.
This release modifies the HTML structure of some of the major theme sections (in particular, the sidebar and top-bar). If you had custom CSS or JavaScript that assumed a particular HTML structure, double-check that it still behaves the same way, as you may need to adjust things for the new structure.
This brings in some extra improvements to the sidebar's behavior and fixes some bugs from the first release candidate. See https://github.com/executab
This brings in some extra improvements to the sidebar's behavior and fixes some bugs from the first release candidate. See https://github.com/executablebooks/sphinx-book-theme/releases/tag/v0.3.0rc1 for more changes.
This is a significant change in the HTML and CSS of the site, with the goal of making it more standardized and robust. There are several design tweaks
This is a significant change in the HTML and CSS of the site, with the goal of making it more standardized and robust. There are several design tweaks that have been made. Here is a short overview:
sticky and other CSS behaviors more dependable.See the PRs below for where most of these changes occurred.
This release includes a few under-the-hood and performance improvements to the CSS and HTML of the theme. While there are no major new features, some
This release includes a few under-the-hood and performance improvements to the CSS and HTML of the theme. While there are no major new features, some of these changes have restructured the HTML so double-check your documentation, especially if you had custom CSS rules the sidebar.
Here are a few improvements:
The right Table of Contents is now hidden using the Intersection Observer API which will reduce the number of JavaScript calls and improve reliability of this feature. #448 (@choldgraf)
The left sidebar is now toggle-able only with CSS, which should make it less prone to failure due to other conflicting javascript on the page. It now includes a "sidebar drawer" on mobile that gives more vertical space for the sidebar. #454 (@choldgraf)
You can now add Deepnote buttons for notebook launch buttons #385 (@jakubzitny)
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v0.1.10...v0.2.0
🔧 MAINTAIN: Remove click dependency by @chrisjsewell in https://github.com/executablebooks/sphinx-book-theme/pull/457
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v0.1.9...v0.1.10
This is a minor release to fix an anchor link bug that was introduced in 0.1.8
This is a minor release to fix an anchor link bug that was introduced in 0.1.8
Maintenance release, to remove the unused click dependency.
This includes a few minor improvements to the theme's CSS and PDF printing styles. See CHANGELOG.md for details.
This includes a few minor improvements to the theme's CSS and PDF printing styles. See CHANGELOG.md for details.
This is a minor release to fix a bug that was introduced which broke the right sidebar anchor links.
This release primarily updates the pydata theme to bring in a few new theme features and bug-fixes.
This release primarily updates the pydata theme to bring in a few new theme features and bug-fixes.
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v0.1.6...v0.1.7
This is a minor release that makes a few bugfixes and small enhancements.
See CHANGELOG.md for more information.
See CHANGELOG.md for more information.
Full Changelog: https://github.com/executablebooks/sphinx-book-theme/compare/v0.1.6...v0.1.7
This release primarily updates the pydata theme to bring in a few new theme features and bug-fixes.
See the CHANGELOG for more information.
See the CHANGELOG for more information.
See the CHANGELOG for more information.
See the CHANGELOG for more information.
See the CHANGELOG for more information.
See the CHANGELOG for more information.
Nothing published for this version
A little release with some style updates. See the CHANGELOG for more information.
A little release with some style updates. See the CHANGELOG for more information.
Nothing published for this version
🐛 FIX: hover target bug on right TOC #300 (@DrDrij)
See the CHANGELOG for release information.
See the CHANGELOG for release information.
See `CHANGELOG.md`
See CHANGELOG.md
sphinx sidebars functionality #233 (@choldgraf). You can now use the html_sidebars functionality that is native in Sphinx. See the sidebars documentat
html_sidebars functionality that is native in Sphinx. See the sidebars documentation.show_navbar_depth.Nothing published for this version
See CHANGELOG.md
See CHANGELOG.md
See CHANGELOG.md
✨ NEW: Sphinx translations for all buttons and tooltips in major UI elements. See the Sphinx i18n documentation for how to activate other languages. #214 (@chrisjsewell)
⬆️ UPGRADE: pydata-sphinx-theme v0.4.0. See the pydata-sphinx-theme changelog for more information.
⬆️ UPGRADE: Use pyScss instead of libsass for scss compilation. This should make the theme more lightweight to install and develop locally. #200 (@hason)
(GitHub contributors page for this release)
@choldgraf | @chrisjsewell | @fm75 | @hason | @najuzilu | @nathancarter | @pauleveritt | @pradyunsg |
See CHANGELOG.md
See CHANGELOG.md
👌 IMPROVED: The main theme change in this release, is the addition of CSS styling for definition lists, including those created by sphinx.ext.autodoc. See Definition and Field Lists, and the Python API documentation.
🔧 MAINTENANCE: Under the hood, there has also been work undertaken to improve the development environment for working with the package. Thanks to @pradyunsg.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →