[Docutils-users] docutils 0.17 released

[engelbert g. <eng...@gm...>]

Release Notes

* Installing with ``setup.py`` now requires setuptools_.
  Alternatively, install with pip_.

* The generic command line front end tool docutils-cli.py_ allows
  the free selection of reader, parser, and writer components.

* New, experimental wrapper to integrate the
  `recommonmark`__ Markdown parser for use with Docutils.

  __ https://pypi.org/project/recommonmark/

* HTML5 writer:

  - Use the new semantic tags <main>, <section>, <header>,
    <footer>, <aside>, <figure>, and <figcaption>.
    See ``minimal.css`` and ``plain.css`` for styling rule examples.

    Change the `initial_header_level`_ setting's default to "2", as browsers
    use the `same style for <h1> and <h2> when nested in a section`__.

  - Use HTML text-level tags <small>, <s>, <q>, <dfn>, <var>, <samp>, <kbd>,
    <i>, <b>, <u>, <mark>, and <bdi> if a matching class value
    is found in `inline` and `literal` elements.
    Use <ins> and <del> if a matching class value
    is found in `inline`, `literal`, or `container` elements.

  - New optional style ``responsive.css``, adapts to different screen
    sizes.

  - New option embed_images_.

  .. _initial_header_level: docs/user/config.html#initial-header-level
  __
https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article
  .. _embed_images: docs/user/config.html#embed-images

* docutils/writers/html5_polyglot/

  - ``minimal.css``: Move non-essential styling to ``plain.css``.
    Code line numbers as pseudo-elements which are skipped when
    copying text.
  - ``plain.css``: Support numbered figures.

* LaTeX writer:

  - New configuration setting `legacy_class_functions`_.

  - The special value "auto" for the `graphicx_option`_ setting
    is no longer supported (it never worked for xetex/luatex).

  - `Styling commands`__ using the legacy ``\docutilsrole`` prefix are
    now ignored. Use ``\DUrole``.

    __ docs/user/latex.html#classes

  - Most helper commands and element definitions are now defined in the
    LaTeX package `docutils.sty`_ and only inserted in the document
    preamble if the stylesheet__ setting does not lists "docutils".

    __ docs/user/config.html#stylesheet-latex-writers

  - Remove legacy LaTeX stylesheet ``docutils-05-compat.sty``.

  - Fixes (thanks to) from John Thorvald Wodder II:
    alignment of nested tables, support memoir document class,

* pseudoxml-writer got a ``--detailled`` option for pretty printing text
nodes.

* odf/odt-writer improved metadata handling.

* manpage-writer fixes #380 commandline option in spinx, #126 title with
spaces,
  #168 empty citation, #394 newline after rubric.

* Miscellaneous:

  - Fixes in Arabic mappings and Korean translations.
  - directives: Prevent infinte inclusion loops.
  - roles: Apply patch #174 `Lowercase new role names on registration`
    by John Thorvald Wodder II.

cheers
 engelbert