Docutils

===========================

* Declare support for languages Georgian and Catalan (Valencian).

* Fix test failures.

=================================

* Document Tree / Docutils DTD

- Remove declaration of unsupported element <info>.
- Remove <decoration> from content declaration of <section> elements.

===========================

The sdist in 0.21 was incomplete

- pypi allows no file replacing
- adding a postrelease suffix "post1": docutils-0.21.post1.tar.gz
works on pypi, but fails with pip because the metadata differs.

But if the metadata is 0.21.post1 pypi makes it a new release.

0.21.1 is the same code except for the version number.

=========================

* General:

- Drop support for Python 3.7 and 3.8.

- Provide ``rst2*`` "console_scripts" `entry points`_
(without the ``.py`` extension) instead of installing the
``rst2*.py`` `front end tools`_ in the binary PATH. []_

Exceptions: ``rstpep2html.py`` and ``rst2odt_prepstyles.py``:

- Use ``docutils --reader=pep --writer=pep_html`` for a PEP preview. []_
- Use ``python -m docutils.writers.odf_odt.prepstyles``
to `strip the page size`__ from an ODT writer stylesheet.

__ docs/user/odt.htmlpage-size

.. [] Some Linux distributions already use the short names.
.. [] The final rendering is done by a Sphinx-based build system
(cf. :PEP:`676`).

* reStructuredText:

- Use the same CSV format for the ``:header:`` option and the main data
of the "csv-table_" directive.

- New option "loading" for the `"image" directive`_.
Sets the new attribute loading__ of the <image> doctree element.

__ docs/ref/doctree.htmlloading

* Configuration changes:

- New configuration setting root_prefix_.
Configurable root directory for included files.

- New configuration setting sources_ for the "buildhtml.py" application.

- Simpler and more secure `input encoding`_ default behaviour:

Do not use the locale encoding as fallback if Python is started in
`UTF-8 mode`_. Stop using "latin1" as second fallback.

Remove BOM (U+FEFF ZWNBSP at start of data) only if the `input_encoding`_
configuration setting is None, '', 'utf-8-sig', 'utf-16', or 'utf-32'.
Do not remove other ZWNBSPs.

* Output changes:

HTML5:
Stop setting the "footnote-reference" class value for footnote
references. Use the CSS selector ``[role="doc-noteref"]``
(works since Docutils 0.18, see minimal.css for examples).

Fix MathML rendering problems in Chrome/Chromium based browsers.

Embed SVG images as ``<svg>`` instead of data-URI.

manpage:
Use .EE/.EX macros for literal blocks.

Render URI references (do not use .UR/.UE).

Use box option for tables.

* Removed objects:

`docutils.nodes.reprunicode`, `docutils.nodes.ensure_str()`
Python 2 compatibility hacks
`docutils.utils.Reporter.set_conditions()`
obsolete
`docutils.core.Publisher.setup_option_parser()`
internal, obsolete

* New files:

``docutils/writers/html5_polyglot/italic-field-names.css``
Alternative style for Docutils field-lists.

* Removed files:

``install.py``, ``setup.py``
Metadata is now stored in ``pyproject.toml``,
supported by pip_ since version 19.0 (2019-01-22).
See README__ for installation alternatives.

__ README.htmlinstallation

* Bugfixes and improvements (see HISTORY_).

.. _input encoding: docs/api/publisher.htmlencodings
.. _csv-table: docs/ref/rst/directives.htmlcsv-table
.. _"image" directive: docs/ref/rst/directives.htmlimage
.. _root_prefix: docs/user/config.htmlroot-prefix
.. _sources: docs/user/config.htmlsources

===========================

Bugfix release. See HISTORY_ for details.

=========================

.. Note::

Docutils 0.20 is the last version supporting Python 3.7 and 3.8.

* General

- Support Python 3.11 (patch 198 by Hugo van Kemenade).

* Output changes:

HTML5:
Use dpub-ARIA role "doc-footnote" (instead of ARIA role "note")
for footnotes.

LaTeX:
Do not load the `inputenc` package in UTF-8 encoded LaTeX sources.
(UTF-8 is the default encoding for LaTeX2e since 2018).

* Configuration changes:

- Settings in the [latex2e writer] configuration file section
are now ignored by the "xetex" writer.
Place common settings in section `[latex writers]`_.

- New command line setting output_. Obsoletes the ``<destination>``
positional argument (cf. `future changes`__).

__ `command-line usage pattern`_

* `utils.find_file_in_dirs()` now returns a POSIX path also on Windows;
`utils.get_stylesheet_list()` no longer converts ``\`` to ``/``.

* docutils/languages/
docutils/parsers/rst/languages/

- Support Ukrainian. Patch by Dmytro Kazanzhy.

* test/coverage.sh

- Removed. Use the coverage.py_ project instead,
``coverage run test/alltests.py`` and ``coverage report``.

* tools/

- Moved ``quicktest.py`` to ``tools/dev/``.

* Bugfixes and improvements (see HISTORY_).

.. _[latex writers]: docs/user/config.htmllatex-writers
.. _output: docs/user/config.htmloutput
.. _coverage.py: https://pypi.org/project/coverage/