crate / crate-docs-theme

A Sphinx theme for the CrateDB documentation.

Home Page:https://crate-docs-theme.readthedocs.io/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation: Upgrade `docutils` package

amotl opened this issue · comments

Hi there,

docutils 0.17 starts using new semantic tags of HTML5

The current release of docutils 0.17 from 3rd April, 2021 [1] starts using the new semantic tags <main>, <section>, <header>, <footer>, <aside>, <figure>, and <figcaption>. See also sphinx-doc/sphinx#9001.

We should account for that within the CSS stylesheets here.

The release notes mention in this regard:

See minimal.css and plain.css for styling rule examples.
New optional style responsive.css, adapts to different screen sizes.

For a detailed list of changes, please see the Docutils HISTORY [2]. The corresponding upstream CSS stylesheets of the new HTML5 polyglot writer of docutils can be reviewed at [3] and the commit log at [4].

With kind regards,
Andreas.

[1] https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-17-2021-04-03
[2] https://docutils.sourceforge.io/HISTORY.html
[3] https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/docutils/writers/html5_polyglot/
[4] https://sourceforge.net/p/docutils/code/HEAD/log/?path=/trunk/docutils/docutils/writers/html5_polyglot

docutils==0.18 has been released on 2021-10-26, see Release 0.18 (2021-10-26).

docutils==0.19 has been released on 2022-07-05, see Release 0.19 (2022-07-05).

docutils 0.20 and 0.20.1 have been released in May 2023.