Changelog

Development version (1.0.1alpha1)

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

备注

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

备注

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