Changelog

3.0.2

Show current translation when the flyout is attached
Fix JavaScript issue that didn’t allow users to disable selectors

3.0.1

Use black color for text in selectors.

3.0.0

Final version.

3.0.0rc4

Fixes

Trigger “Read the Docs Search addon” when focusing the “Search docs” input in the navbar.

3.0.0rc3

Fixes

Show hidden version in selector if it’s the current active version

3.0.0rc2

Added

Render version and language selectors below the documentation’s title (top left). This can be controlled via the new theme options version_selector and language_selector.

3.0.0rc1

Added

Added support for Sphinx 8.
Added support for Python 3.12.
Added support for docutils >0.18, <0.22.
Populate html_context with all the environment variables starting with READTHEDOCS_.

Deprecations

Drop support for Sphinx <6.0.
Drop support for Python <3.8.
analytics_id and analytics_anonymize_ip are deprecated, use sphinxcontrib-googleanalytics instead.
Drop support for all versions of Internet Explorer.
Raise a warning when defining html_theme_path. This was an old config that’s not required anymore.
extra_css_files is deprecated and support will be removed in a future version.

2.1.0rc2

Added

Added flyout_display option to display the flyout attached (bottom of the sidebard) or hidden (default).

2.1.0rc1

Added

Render the menu versions/languages selector (flyout) using the new readthedocs-addons-data-ready Read the Docs Addons CustomEvent.

Deprecations

Remove html5shiv.

2.0.0

Added

Support for Sphinx versions 6.x and 7.x
Support for docutils <=0.20

Deprecations

The HTML4 writer is now officially deprecated. An error will be thrown if your project configuration still uses the HTML4 writer.
Support for Sphinx versions < 5.0 was removed.
In addition, our supported dependencies will match the dependencies from our lowest supported Sphinx release, version 5.0: Python >= 3.6 and docutils > 0.14 and < 0.19

1.3.0

Added

Relaxed requirements to include Sphinx release 7.0

1.2.2

Fixes

Require sphinxcontrib-jquery>=4,<5 (#1446)

Added

Styling for :menuselection: (#1426)

1.2.1

Fixes

Load jQuery correctly when using latest sphinxcontrib-jquery release (#1448)

1.2.0

Dependency changes

docutils 0.18 is supported. (#1381)
Sphinx 6 support added
Added sphinxcontrib-jquery as a dependency (#1385 #1421)
Python 3.11 is officially supported and tested. (#1395)
Python 3.4 and 3.5 are officially not supported (#1395)

Changes

Automatically use sphinxcontrib-jquery in Sphinx 6+ (#1399)
Use new context vars logo_url, favicon_url and root_doc when available (#1405)
Translations updated: French, Hungarian, Croatian
Translations added: Danish, Chinese (Taiwan)

Note for users of Sphinx<4

If you cannot use a more recent Sphinx release, you should at least ensure you are using the most recent release for your major version. Currently, these are Sphinx 1.8.6 and 2.4.5. Older releases may install unsupported versions of several dependencies, including Jinja2 and docutils.

Known issues

In some cases, jQuery is not loaded with Sphinx 6 on Read the Docs. Workaround: You need to add sphinx_rtd_theme to extensions in your conf.py. See readthedocs.org issue #9654 for updates.

1.1.1

Fixes

Fix wrapping bug on cross references (#1368)

1.1.0

Dependency Changes

Many documentation projects depend on sphinx-rtd-theme without specifying a version of the theme (unpinned) while also depending on unpinned versions of Sphinx. The latest version of sphinx-rtd-theme ideally always supports the latest version of Sphinx, but this is now guaranteed.

This release adds upper bounds to direct dependencies Sphinx and docutils which will safeguard from mixing with possibly incompatible future versions of Sphinx & docutils.

Sphinx versions supported: 1.6 to 5.2.x
Sphinx<6 (#1332)
docutils<0.18 (unchanged, but will be bumped in an upcoming release)

Features

Nicer styles for <kbd> (#967)
New styling for breadcrumbs (#1073)

Fixes

Suffixes in Sphinx version caused build errors (#1345)
Table cells with multiple paragraphs gets wrong formatting (#289)
Definition lists rendered wrongly in api docs (#1052)
Citation not styled properly (#1078)
Long URLs did not wrap (#1193)

Minor Changes

Sphinx 5.2 added to test matrix (#1348)
Python 3.10 added to test matrix (#1334)
Supplemental Docker setup for development (#1319)
Most of setup.py migrated to setup.cfg (#1116)
Jinja2 context variable sphinx_version_info is now (major, minor, -1), the patch component is always -1. Reason: It’s complicated. (#1345)

Incompatible Changes

There are no known incompatible changes in this release. Support for docutils versions 0.18 and 0.19 are scheduled for our next release.

1.0.0

Incompatible Changes

The minimum supported python version is now 2.7 or 3.4 and greater (#1093)
The minimum supported Sphinx version is now 1.6 (#1091)

Deprecated

Support for Sphinx’s HTML4 writer is deprecated and will be removed in version 2.0 (#1091)

Features

Add support for Sphinx 4.x (#1123)
Add support for Docutils 0.17 (#1185 and #1199)
Fixed logo scaling on IE11 (#1183)
Added support for logos as URLs (#1171)
Align top and side navigation background colors on mobile (#1132)
Added support for deep toc levels (#1089)
Updated translations for Chinese, Dutch, Estonian, French, German, Italian, Lithuanian, Persian, Polish, Portuguese, Russian, Spanish, Swedish, and Turkish locales

A number of accessibility features were added in this release:

Allow keyboard to toggle menu expansion (#1167)
Allow keyboard to activate permalink (#1162)
Show keyboard focus on buttons (#1161)
Maintain aria-expanded along with .current in menu (#1151)
Respect tab order for prev/next buttons (#1051)

Fixes

Updated Google analytics integration (#1129)
Add classifier separation on Sphinx 2+ HTML4 writer (#1192)
Added missing space char in footer (#1188)
Fix navigation right padding on level2+ elements (#1068)
Fix navigation expansion button sizes (#1067)
Wrap inline literals (#1050)
Fix aria labels (#1056)
Don’t toggle navigation terminal nodes (#1049)
Fix <pre> overflow (#1220)
Fix literal/ref style inside <dl> (#1088)

Other Changes

Update npm development dependencies (#1096)
Don’t require npm to build from source (#1039)
Use regular toctree instead of toc for singlehtml builder (#507)
Cleanup whitespace in templates (#1060)

0.5.2

Date:: April 5, 2021

Note

This commit will not be in master, but was branched directly off 0.5.1 to minimize issues. The next full release will contain all PR’s previously merged.

Depend on docutils < 0.17 (#1113)

0.5.1

Date:: January 4, 2021

Fixes

Set url_root properly on index (#1025)
Do not load language_data.js in non-search pages (#1021)
Hide the search box on any singlehtml like builder (#975)
Fix vcs_pageview_mode template parameter (#1010)
Mark nex/prev icons as aria-hidden (#1007)
Use well-formed XML syntax (#1006)
Footer: show both commit and last_updated if available (#897)
Search page: don’t show “edit on” links (#935)

New Features

New theme option to enable anonymous ip addresses when using Google Analytics (#889)

Other Changes

The canonical_url option was deprecated in favor of Sphinx’s html_baseurl (#1003)
Add contentinfo block to footer.html template (#896)
Make Copyright template match sphinx’s basic (#933)
Packaging: include bin/preinstall.js (#1005)

0.5.0

Date:: Jun 17, 2020

Fixes

Fix bullet list spacing to respect simple/complex list styles

0.5.0rc2

Date:: June 5, 2020

Fixes

Fix issue with simple definition lists that was missed
Change FOUT back to FOIT
Fix several margin issues with lists, nested lists, and nested content
Add colon back to field lists

0.5.0rc1

Date:: May 6, 2020

Fixes

Fix many styling issues that look different when using the Sphinx HTML5 writer

Other Changes

Add the navigation template block around the navigation area.
Added i18n support using Babel
Added translations for 10 new languages
Moved build system from Grunt and friends to Webpack
Remove Modernizr, but keep html5shiv (#724, #525)

0.4.3

Date:: Feb 12, 2019

New Features

Fixes

Fix scrolling to active item in sidebar on load (#214)
Style caption link for code and literal blocks
Fix inconsistent font size and line height for autodoc “raises” and “returns” (#267)
Fix last_updated notice appearing in same line as copyright notice (#704)

Other Changes

0.4.2

Date:: Oct 5, 2018

New Features

Fixes

Set base font size on <html> (#668)
Fix HTML search not working with Sphinx-1.8 (#672)

Other Changes

Upload signed packages to PyPI with twine (#651)
Do not enforce period at the end of copyright statement (666)

0.4.1

Date:: July 27, 2018

New Features

Fixes

Line height adjustments for Liberation Mono (#656)

Other Changes

Add Sphinx as a dependency

0.4.0

This version made some changes to how JS and CSS were included when the theme is used on Read the Docs.

New Features

Fixes

Do not rely on readthedocs.org for CSS/JS (#614)
Color accessibility improvements on the left navigation

Other Changes

Write theme version and build date at top of JavaScript and CSS
Changed code and literals to use a native font stack (#612)
Fix small styling issues

0.3.1

Fixes

Revert part of #576 causing display issues with version selector menu
Backwards compatibility fixes for pre-0.3.0 releases (#623)
Fix mkdocs version selector (#622)
Add open list spacing (#591)
Fix table centering (#599)

0.3.0

Note: this version resulted in some JavaScript incompatibilities when used on readthedocs.org

New Features

Add html language attribute
Allow setting ‘rel’ and ‘title’ attributes for stylesheets (#551)
Add option to style external links
Add github, gitlab, bitbucket page arguments option
Add pygments support
Add setuptools entry point allowing to use sphinx_rtd_theme as Sphinx html_theme directly.
Add language to the JS output variable

Fixes

Fix some HTML warnings and errors
Fix many styling issues
Fix many sidebar glitches
Fix line number spacing to align with the code lines
Hide Edit links on auto created pages
Include missing font files with the theme

Other Changes

Significant improvement of our documentation
Compress our Javascript files
Updated dependencies

0.2.4

Yet another patch to deal with extra builders outside Spinx, such as the singlehtml builders from the Read the Docs Sphinx extension

0.2.3

Temporarily patch Sphinx issue with singlehtml builder by inspecting the builder in template.

0.2.2

Roll back toctree fix in 0.2.1 (#367). This didn’t fix the issue and introduced another bug with toctrees display.

0.2.1

Add the rel HTML attribute to the footer links which point to the previous and next pages.
Fix toctree issue caused by Sphinx singlehtml builder (#367)

0.2.0

Adds the comments block after the body block in the template
Added “Edit on GitLab” support
Many bug fixes

0.1.10-alpha

Note

This is a pre-release version

Removes Sphinx dependency
Fixes hamburger on mobile display
Adds a body_begin block to the template
Added prev_next_buttons_location

0.1.9

Intermittent scrollbar visibility bug fixed. This change introduces a backwards incompatible change to the theme’s layout HTML. This should only be a problem for derivative themes that have overridden styling of nav elements using direct descendant selectors. See #215 for more information.
Safari overscroll bug fixed
Version added to the nav header
Revision id was added to the documentation footer if you are using RTD
An extra block, extrafooter was added to allow extra content in the document footer block
Fixed modernizr URL
Small display style changes on code blocks, figure captions, and nav elements

0.1.8

Start keeping changelog :)
Support for third and fourth level headers in the sidebar
Add support for Sphinx 1.3
Add sidebar headers for :caption: in Sphinx toctree
Clean up sidebar scrolling behavior so it never scrolls out of view