crate-docs-theme
crate-docs-theme copied to clipboard
Documentation: Upgrade `docutils` package
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 https://github.com/sphinx-doc/sphinx/issues/9001.
We should account for that within the CSS stylesheets here.
The release notes mention in this regard:
See
minimal.css
andplain.css
for styling rule examples. New optional styleresponsive.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 has been upgraded with recent modernizations.
- GH-390
- GH-486