crate-docs-theme icon indicating copy to clipboard operation
crate-docs-theme copied to clipboard

Documentation: Upgrade `docutils` package

Open amotl opened this issue 3 years ago • 3 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 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 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

amotl avatar Apr 12 '21 14:04 amotl

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

amotl avatar Jun 03 '22 15:06 amotl

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

amotl avatar Jul 22 '22 10:07 amotl

docutils 0.20 and 0.20.1 have been released in May 2023.

amotl avatar Jul 22 '23 11:07 amotl

docutils has been upgraded with recent modernizations.

  • GH-390
  • GH-486

amotl avatar Aug 07 '24 15:08 amotl