.. include:: docs/header0.txt ================== Docutils History ================== :Author: David Goodger; open to all Docutils developers :Contact: docutils-develop@lists.sourceforge.net :Date: $Date: 2024-03-27 01:06:08 +0100 (Mi, 27. Mär 2024) $ :Revision: $Revision: 9603 $ :Web site: https://docutils.sourceforge.io/ :Copyright: This document has been placed in the public domain. .. contents:: Changes since 0.21.rc1 ====================== ... Release 0.21.rc1 (2024-03-26) ============================= * General - Drop support for Python 3.7 and 3.8. - Updated build system to use Flit_ (patch #186 by Adam Turner). Removed ``setup.py``. - Provide ``rst2*`` "console_scripts" `entry points`_ (without the ``.py`` extension) instead of installing the ``rst2*.py`` front end tools in the binary PATH. .. _Flit: https://github.com/pypa/flit/ * docs/ref/docutils.dtd - The element accepts a new attribute "loading". - Fix definitions (no change to actual behaviour): * The element uses the attribute "xml:space". * The element may contain text only (no inline elements). * docutils/frontend.py - Allow `validate_*()` functions to be called with just the "value" argument but keep the legacy interface for use with optparse. - New function `frontend.validate_math_output()`. * docutils/io.py - 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. .. _UTF-8 mode: https://docs.python.org/3/library/os.html#utf8-mode .. _input encoding: docs/api/publisher.html#encodings - Auto-close `FileInput.source` in case of reading/decoding errors. * docutils/languages/, docutils/parsers/rst/languages/ - Mark/Fix mistranslated localizations of the "admonition" directive name. In Docutils, "admonition" is used as a generic term for "advice"/"advisory"/"remark", not a reprimand. - Add support for Georgian language (patch #204 by Temuri Doghonadze). - Update/complete Catalan translations (patch #203 by Antoni Bella Pérez). * docutils/nodes.py - Remove compatibility hacks `nodes.reprunicode` and `nodes.ensure_str()`. * docutils/parsers/rst/directives/images.py - New "image" directive option "loading". * docutils/parsers/rst/directives/tables.py - Use the same CSV format for the ``:header:`` option and the main data of the "csv-table" directive. - Move `parsers.rst.directives.Table.process_header_option()` method to `parsers.rst.directives.CSVTable`. * docutils/parsers/rst/states.py - Don't split inside "< >" when parsing "option groups" (fixes bug #474). * docutils/parsers/rst/directives/misc.py, docutils/parsers/rst/directives/tables.py - Consider the new root_prefix_ setting when including files with "include", "raw", or "csv-table" directives. * docutils/utils/math/* - Use custom exception `utils.math.MathError` instead of abusing `SyntaxError` for LaTeX math syntax errors. - Unify interface of LaTeX -> MathML conversion functions. Improve error reporting. - Sort ℏ (`\hslash`) as "mathord", not "mathalpha". * docutils/utils/math/latex2mathml.py - Generate "MathML Core" to fix rendering with Chromium/Android. Use CSS rules instead of the deprecated "columnalign" attribute to style as "align" environment. Use Mathematical Alphanumeric Symbols instead of with "mathvariant" attribute. - Use instead of for character class "mathord". - Support "aligned" environment. - Eliminate side-effect on later import of "tex2unichar". * docutils/utils/math/mathml_elements.py - New module defining MathML element classes (outsourced from latex2mathml.py). - Base MathML element classes on `xml.etree.ElementTree`. * docutils/utils/roman.py - Update to version `1.4 `__. Fixes feature-request #95 (license is now ZPL 2.1). * docutils/utils/smartquotes.py - Pre-compile regexps once, not with every call of `educateQuotes()` (patch #206 by Chris Sewell). - Simplify regexps; skip replacement rules if there is nothing to replace. * docutils/writers/html4css1/__init__.py - Support video inclusion via ```` tags. * docutils/writers/html5_polyglot/\*.css - Move MathML styles to "minimal.css" (required for correct rendering). - Highlight heading of target section also with explicit hyperlink target. * docutils/writers/_html_base.py - Stop setting the "footnote-reference" class value for footnote references. Since 0.18, you can use the CSS selector ``[role="doc-noteref"]``. - Support reading/embedding images also with "file:" URI. - Warn, if image scaling fails because the image file cannot be read. - Support video inclusion via ``