Released 2024-10-24
- When getting the canonical URL on Read the Docs, replace the path with
/en/stable/
instead of/page/
. This can be configured withrtd_canonical_path
. :pr:`122` - The version banner can be disabled by setting
version_banner = False
. On Read the Docs, it is disabled when building thestable
version or PRs. :pr:`123`
Released 2024-10-15
- Get canonical URL from environment variable when building on Read the Docs. :pr:`117`
- New version warning banner. Use JavaScript to query PyPI when viewing a page, rather than baking the warning into the build. New builds of old versions are no longer required for the banner to be correct. :pr:`117`
- Generate 404 page using the sphinx-notfound-page extension. This fixes the URLs when the page is hosted so that it loads the CSS. :issue:`34`
- Remove handling for
singlehtml_sidebars
config which predated Sphinx's support. :pr:`119` - Remove "babel" and "platter" theme variants which were undocumented and did not appear to be used by the relevant projects. :pr:`120`
Released 2024-04-29
- Allow Sphinx's parallel build feature. :issue:`88`
Released 2024-04-19
- Use modern packaging metadata with
pyproject.toml
instead ofsetup.cfg
. - Use
flit_core
instead ofsetuptools
as build backend. - Compatibility with changes in Sphinx 7.3. :pr:`100`
Released 2023-06-08
- Remove leftover Python 2 compatibility code. :pr:`69`
- Dotted underlines on links are smaller. :issue:`70`
Released 2023-04-25
- Drop support for Python 3.6 and 3.7.
- Require Sphinx >= 3.
- Remove previously deprecated code.
- Fix table of contents overflow issue.
Released 2022-12-24
- Fix compatibility with
packaging>=22
.
Released 2021-11-10
- Detect if Sphinx dirhtml builder is generating canonical URLs with ".html" and replace with the correct dir URL. :issue:`47`
canonical_url
config is deprecated. Use Sphinx's built-inhtml_baseurl
config instead. :pr:`53`- Address deprecations in Jinja 2.0. :pr:`54`
Released 2021-05-20
- Remove workaround for search URLs when using the
dirhtml
builder. The issue has been fixed in Sphinx and the workaround was causing the issue again. :issue:`39` - Remove
html_context["readthedocs_docsearch"]
for controlling whether Read the Docs' search is used. :issue:`40` - Add an
ethicalads.html
sidebar to have Read the Docs always show ads in the sidebar instead of other possible locations. The sidebar is enabled by default at the end of the list. :issue:`41`
Released 2021-05-11
- Drop Python < 3.6.
- Update for Jinja 2.0.
- Update for Click 8.0.
Released 2020-01-02
- Use built-in :mod:`importlib.metadata` on Python 3.8. :pr:`27`
Released 2019-07-04
- Make the version warning sticky so that it appears when linking to the middle of a document. :issue:`5`
- Remove CSS for old ads.
Released 2019-07-29
- Sort versions taken from Read the Docs so that 2.10.x is considered newer than 2.9.x. :issue:`24`
Released 2019-07-26
- Use HTTPS for font URLs in CSS. :pr:`22`
- Don't require
sphinx.ext.autodoc
to be enabled. - Implement the Jinja directives
jinja:filters::
,jinja:tests::
, andjinja:nodes::
. - Generate a table of contents for Jinja filters and tests.
- Update the
babel
andplatter
themes.
Released 2019-01-28
- Store a page's canonical URL in
html_context["page_canonical_url"]
rather than overwritingcanonical_url
, for compatibility with Read the Docs. :pr:`21`
Released 2019-01-28
- Move the Read the Docs search flag to the
footer
block to ensure it executes after Read the Docs injects its data. :pr:`20`
Released 2018-09-24
- Strip ".x" placeholder when parsing versions for sidebar. :issue:`7`, :pr:`17`
Released 2018-09-16
- Add configurable ".x" placholder to versions, producing strings like "1.2.x". :issue:`6`, :pr:`12`
- Add dependency on "packaging" to support older Sphinx versions. :issue:`9`, :pr:`11`
- Backport
shlex.quote
for Python 2. :issue:`13`, :pr:`14`
Released 2018-08-28
- Modernize
click
theme. The.. click:example::
and.. click:run::
directives used by Click are available and ported to Python 3. - Modernize
werkzeug
theme. :pr:`4` - Modernize
jinja
theme. Local extensions used by Jinja are not available yet. - Remove theme entry points to make late configuration consistent. The
themes are available when
"pallets_sphinx_themes"
is added toextensions
. - Only run event callbacks added by theme when the theme is actually in use. This allows the package to be installed without interfering with other themes.
- Support
html_context["versions"]
in the format injected by Read the Docs. - Set
html_context["readthedocs_docsearch"]
to opt in to replacing Sphinx's built-in search with Read the Docs' new implementation. - Make version handling more robust for various configurations.
- Autodoc skips docstrings that contain the line
:internal:
. - Autodoc removes lines that start with
:copyright:
or:license:
from module docstrings. - Add
singlehtml_sidebars
config for Sphinx < 1.8. - Add
hide-header
CSS class to hide the page header with.. rst-class:: hide-header
. The header is still useable by assistive technology. This is useful for replacing the header with a large logo image. - Disable the sidebar logo on the index page with
html_theme_options["index_sidebar_logo"] = False
.
Released 2018-04-29
- Work around an issues with search when using the
dirhtml
builder. :pr:`3`
Released 2018-04-18
- Major rewrite of CSS and HTML templates to clean up and reduce
complexity. Widen columns, improve responsive breakpoints. Currently
all themes are available, but only
pocoo
andflask
themes are modernized. - Parse
html_context["versions"]
. These will be rendered in theversions.html
sidebar. When viewing an old version, or the development version, a warning is displayed at the top of each page. - Add a
ProjectLink
named tuple. A list of these inhtml_context["project_links"]
will be rendered in theproject.html
sidebar. - Add a
get_version
function to ensure a project is installed and get its version information. - Use
html_context["canonical_url"]
as a base URL to build a canonical URL link on each page. - Add Sphinx entry points for themes.
- Rename from "pocoo-sphinx-themes". See commit f675bfc for the old themes from the docbuilder.