Log message:
py-docutils: update to 0.20.
Release 0.20 (2023-05-09)
=========================
* General
- Docutils 0.20 is the last version supporting Python 3.7 and 3.8.
- Support Python 3.11 (patch #198 by Hugo van Kemenade).
* docutils/core.py
- New functions `rst2…()` for use as "console_scripts" `entry points`_.
(cf. `Future changes` in the RELEASE-NOTES_).
* docutils/frontend.py
- New configuration setting "output_". Obsoletes the \
``<destination>``
positional argument (cf. `Future changes` in the RELEASE-NOTES_).
* docutils/languages/
docutils/parsers/rst/languages/
- Support Ukrainian. Patch by Dmytro Kazanzhy.
* docutils/nodes.py
- Fix `previous_sibling()` method that led to invalid HTML in some cases
(cf. patch #195).
- Fix bug #463. Spurious comma in deprecation warning.
* docutils/parsers/recommonmark_wrapper.py
- Improved mock Sphinx module.
* docutils/transforms/__init__.py
- `Transformer.populate_from_components()` now silently ignores
components that are not instances of `docutils.TransformSpec`.
* docutils/transforms/frontmatter.py
- Accept author names with initials like ``A. Einstein`` in the "author"
`bibliographic field`_ instead of rising an error
(generally, such names are `parsed as enumerated list`__).
.. _bibliographic field:
docs/ref/rst/restructuredtext.html#bibliographic-fields
__ docs/ref/rst/restructuredtext.html#enumerated-lists
* docutils/transforms/references.py
- `DanglingReferences` ignores `citation_reference` nodes if the
"use_bibex" setting is active. (In this case, citations are provided
by LaTeX/BibTeX.) Fixes bug #384.
* docutils/utils/__init__.py
- New utility function `xml_declaration()`.
- `DependencyList.add()` accepts `pathlib.Path` instances.
- `find_file_in_dirs()` now returns a POSIX path also on Windows;
`get_stylesheet_list()` no longer converts ``\`` to ``/``.
* docutils/utils/math/latex2mathml.py
- Support "mod" notation for modulo operation / modulus arithmetic.
* docutils/utils/math/tex2mathml_extern.py
- Support `Pandoc` as alternative LaTeX to MathML converter.
Patch by Ximin Luo.
* docutils/writers/_html_base.py
- Refactoring of `HTMLTranslator` initialization and collecting of
document "parts". Adapt HTML writers importing `_html_base`.
Changes to the HTML output (no space character before closing tag of
XML declaration, order of metadata elements)
don't affect the HTML semantics, styling, and rendering.
- Wrap definition lists with "details" class argument in a <div>
with the "id" and "class" values of the list node.
- Use dpub-ARIA role "doc-footnote__" (instead of ARIA role \
"note")
for footnotes.
__ https://www.w3.org/TR/dpub-aria-1.1/#doc-footnote
* docutils/writers/latex2e/__init__.py
- Do not load the `inputenc` package in UTF-8 encoded LaTeX sources.
(UTF-8 is the default encoding for LaTeX2e since 2018).
- Fix behaviour of the use_bibtex_ setting.
- Outsource parts of `depart_document()` to new auxiliary methods
`make_title()` and `append_bibliography()`.
- Ensure POSIX paths in stylesheet loading macros.
* docutils/writers/latex2e/titlepage.tex
- Drop ``\usepackage{fixltx2e}`` from template.
(Obsolete since 2015 and dropped from other templates in Docutils 0.14.)
* docutils/writers/manpage.py
- Do not output empty "manual" in ``.TH``.
* docutils/writers/xetex/__init__.py
- Ignore settings in the [latex2e writer] configuration file section.
Place common settings in section [latex writers].
* setup.py
- Fix SetuptoolsDeprecationWarning: ``Installing '' as data is deprecated``
by adding data directories to package_data.packages list.
* tox.ini
- Extracted flake8 configuration and moved to ``.flake8``.
- changedir to directory ``test`` to avoid path problems.
* test/
- Refactored tests to use common `unittest` idioms.
Fixes errors when running the test suite with ``python -m unittest``
or external test frameworks, such as Pytest_.
.. _pytest: https://pypi.org/project/pytest/
* test/coverage.sh
- Removed. Use the coverage.py_ project instead,
``coverage run test/alltests.py`` and ``coverage report``.
.. _coverage.py: https://pypi.org/project/coverage/
* tools/
- Moved ``quicktest.py`` to ``tools/dev/``.
|
Log message:
py-docutils: update to 0.19.
Release 0.19 (2022-07-05)
=========================
(Release 0.19b1 (2022-06-21))
* Drop support for Python 2.7, 3.5, and 3.6.
* Output changes:
HTML5:
Wrap groups of footnotes in an ``<aside>`` for easier styling.
The CSS rule ``.footnote-list { display: contents; }`` can be used to
restore the behaviour of custom CSS styles.
* After package installation, the CLI commands ``python -m docutils`` and
``docutils`` start the `generic command line front end tool`__.
__ docs/user/tools.html#generic-command-line-front-end
* Support parsing "Markdown" input with 3rd party parsers
myst_, pycmark_, or recommonmark_.
* The default values for the "pep-references", "rfc-base-url",
and "python-home" `configuration settings`_ now use the \
"https:" scheme.
The PEP-writer template's header is updated to fix links and
resemble the header of official PEPs.
* Various bugfixes and improvements (see HISTORY_).
.. _myst: https://pypi.org/project/myst-docutils
.. _pycmark: https://pypi.org/project/pycmark/
.. _recommonmark: https://pypi.org/project/recommonmark/
.. _configuration settings: docs/user/config.html
Release 0.18.1 (2021-12-23)
===========================
.. Note::
Docutils 0.18.x is the last version supporting Python 2.7, 3.5, and 3.6.
* ``nodes.Node.traverse()`` returns a list again to restore backwards
compatibility (fixes bug #431).
Use ``nodes.Node.findall()`` to get an iterator.
* re-add module ``parsers.rst.directives.html``
(stub, emits deprecation warning and loads
"Meta" directive from ist new place at ``parsers.rst.directives.misc``.)
* Small bugfixes (see HISTORY_).
Release 0.18 (2021-10-26)
=========================
* Output changes:
Identifiers:
- During `identifier normalization`_, leading number and hyphen
characters are no longer stripped from a `reference name`_, if the
id_prefix_ setting is non-empty.
Example:
with ``--id-prefix="DU-"``, a section with title "34. \
May"
currently gets the identifier key ``DU-may`` and after the
change the identifier key ``DU-34-may``.
- The default value for the auto_id_prefix_ setting changed to ``%``:
"use the tag name as prefix for auto-generated IDs".
Set auto_id_prefix_ to ``id`` for unchanged auto-IDs.
HTML5:
- Use the semantic tag <aside> for footnote text and citations, topics
(except abstract and toc), admonitions, and system messages.
Use <nav> for the Table of Contents.
- Make "auto" table column widths the default: Only specify column
widths, if the `"widths" option`_ is set and not "auto".
The table-style__ setting "colwidths-grid" restores the current \
default.
.. _"widths" option: __ docs/ref/rst/directives.html#table
__ docs/user/config.html#table-style
- Items of a definition list with class argument "details" are
converted to `details disclosure elements`_. Example::
..class:: details
Summary
This additional information should be hidden.
- Do not add "compound-first", "compound-middle", or \
"compound-last" to
elements nested in a compound. Use child selector and ":first-child",
":last-child" pseudo classes instead.
- Use class value "backrefs" instead of "fn-backref" for \
a span of
back-references.
- Write footnote brackets and field term colons to HTML, so that they
are present also without CSS and when copying text.
- Move space character between section number and heading into
"sectnum" span.
`math-output`_: html
- Support more commands, fix mapping of commands to Unicode characters.
- Scale variable sized operators and big delimiters with CSS.
- Don't use <tt> element (deprecated in HTML5).
- Use STIX fonts if available.
LaTeX:
`legacy_class_functions`_ setting default changed to "False",
admonitions are now environments.
* New standard Docutils doctree node: <meta__>.
* New configuration settings:
- [latex writers] legacy_column_widths_ and
- [html5 writer] image_loading_.
* Removed files:
``iepngfix.htc`` and ``blank.gif`` (IE 6 workaround for `s5_html`).
* Removed sub-module:
``parsers.rst.directives.html``
(reversed in release 0.18.1).
* Removed function: utils.unique_combinations()
(obsoleted by itertools.combinations()).
* Removed attributes:
- ``HTMLTranslator.topic_classes``: check ``node.parent.classes`` instead.
- ``nodes.Text.rawsource``: we store the null-escaped text in Text
nodes since 0.16 so there is no additional information in the
rawsource.
* Major refactoring and fixes/additions in
``docutils/utils/math/math2html.py`` and
``docutils/utils/math/latex2mathml.py``
(mathematical notation in HTML, cf. `LaTeX syntax for mathematics`_).
* nodes.Node.traverse() returns an iterator instead of a list
(reversed in release 0.18.1).
* Various bugfixes and improvements (see HISTORY_).
Fix spelling errors in documentation and docstrings.
Thanks to Dimitri Papadopoulos.
__ docs/ref/doctree.html#meta
.. _identifier normalization:
docs/ref/rst/directives.html#identifier-normalization
.. _id_prefix: docs/user/config.html#id-prefix
.. _auto_id_prefix: docs/user/config.html#auto-id-prefix
.. _details disclosure elements:
https://www.w3.org/TR/html52/interactive-elements.html#the-details-element
.. _LaTeX syntax for mathematics: docs/ref/rst/mathematics.html
.. _legacy_column_widths: docs/user/config.html#legacy-column-widths
|