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
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).