Docutils: Documentation Utilities Code

tagging release 0.21.2

Version 0.21.2

stale comment

Reconcile Docutils DTD and Document Tree documentation.

There are some cases where docutils.dtd and doctree.txt diverged.
Change so, that the documentation is consistent and matches actual behaviour.

Remove declaration of element `<info>`:

* added to docutils.dtd and nodes.py but not doctree.txt 2004-03-21,
* never used,
* removed from nodes.py 2004-11-09.

Remove `<decoration>` from content model of `<section>` elements:

* added to docutils.dtd but not doctree.txt 2004-03-21,
* never used because the Docutils rST parser inserts `<decoration>`
directly into `<document>` even if the "header" or "footer" directive
is nested in a section.

Fix declaration of `<sidebar>` content:

* no `<subtitle>` without `<title>`.

Add `<subtitle>` to children of `<section>` elements in "doctree.txt":

* present in docutils.dtd,
* used in the functional test examples via SectSubTitle transform
(with "sectsubtitle_xform" configuration setting True).

man utf8 output uses normal "-" char(45)

Uncomment classifiers for Georgian and Catalan (Valencian) languages.

Both classifiers were added to the "pypa/trove-classifiers" repository and
should be available on https://pypi.org/classifiers/ in the next few days.

cf. https://github.com/pypa/trove-classifiers/pull/176#issuecomment-2047518230

Small test speedup/simplification.

Directly instantiating the parser class brings down test time from 0.022 s to 0.005 s
while `parsers.get_parser_class()` is tested separately.

Make effect of centre-aligning figures visible in functional HTML text.

Horizontal figure alignment is irrelevant if the figure is full-width.
The figure content is left-aligned with the default styles.

Change the functional test input by specifying 40% figure width to the
example of a centre-aligned figure.

Note: figure alignment is ignored with LaTeX output, figures are
centre-aligned by default (depends on LaTeX packages/documentclass).

Avoid dependency of functional tests on PIL/Pillow.

Don't use "scale" image directive option in functional test.

The expected output for the "image" directive with "scale" option
is tested in `test_writers/test_html5_polyglot_parts.py` and
`test_writers/test_html4css1_parts.py` with special-casing
for missing PIL.

Prevent test failure due no Pillow or Pillow version above 10.3.

Skip tests requiring PIL (Pillow) if it is unavailable.

(Hopefully) fix expected output: Pillow versions above 10.3 seem to report the absolute path.

Thanks to Michał Górny for report and analysis [bugs:485].