Update docutils to 0.17.1

[pyup-bot]

This PR updates docutils from 0.13.1 to 0.17.1.

Changelog

0.17.1

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

0.17.1b.dev

* Bug fixes (for details see the Docutils `HISTORY`_).

0.17

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

* Numerous bug fixes and improvements
(for details see the Docutils `HISTORY`_).

* 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.

* Support Arabic language.

* New, **experimental** wrapper to integrate the `recommonmark`__
Markdown parser for use with Docutils.
Currently only tested with recommonmark version 0.4.0.

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

* HTML5 writer:

- New option embed_images_.

- Use semantic tags (for details see the Docutils `HISTORY`_).

- 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`__.

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

- Move non-essential styling from ``minimal.css`` to ``plain.css``
 rsp. ``responsive.css``.

- Show code line numbers as pseudo-elements so they are skipped when
 copying the code block from the page.

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

* 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.htmlclasses

- 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.htmlstylesheet-latex-writers

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

.. _setuptools: https://pypi.org/project/setuptools/
.. _pip: https://pypi.org/project/pip/
.. _docutils-cli.py: docs/user/tools.htmldocutils-cli-py
.. _legacy_class_functions: docs/user/config.htmllegacy-class-functions
.. _graphicx_option: docs/user/config.htmlgraphicx-option
.. _docutils.sty: https://ctan.org/pkg/docutils

0.16

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

.. Note::

Docutils 0.15.x is the last version supporting Python 2.6, 3.3 and 3.4.

Docutils 0.16.x supports Python 2.7 and Python >= 3.5 natively,
without the use of the ``2to3`` tool.

* reStructuredText:

- Keep `backslash escapes`__ in the document tree. This allows, e.g.,
 escaping of author-separators in `bibliographic fields`__.

__ http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#escaping-mechanism
__ docs/ref/rst/restructuredtext.htmlbibliographic-fields

* LaTeX writer:

- Informal titles of type "rubric" default to bold-italic and left aligned.
- Deprecate ``\docutilsrole`` prefix for styling commands:
 use ``\DUrole`` instead.
- Fix topic subtitle.
- Add "latex writers" to the `config_section_dependencies`.
- Ignore classes for `rubric` elements
 (class wrapper interferes with LaTeX formatting).

* tools/buildhtml.py

- New option "--html-writer" allows to select "html__" (default),
 "html4" or "html5".

__ html: docs/user/html.htmlhtml

* docutils/io.py

- Remove the `handle_io_errors` option from io.FileInput/Output.

* docutils/nodes.py

- If `auto_id_prefix`_ ends with "%", this is replaced with the tag name.

.. _auto_id_prefix: docs/user/config.htmlauto-id-prefix

* Various bugfixes and improvements (see HISTORY_).

0.15

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

.. Note::

Docutils 0.14.x is the last version supporting Python 2.4, 2.5,
3.1, and 3.2.

Docutils 0.15.x is compatible with Python versions 2.6, 2.7 and 3.3 to 3.5
(cf. `Python 3 compatibility`_).

* reStructuredText:

- Allow embedded colons in field list field names (before, tokens like
 ``:this:example:`` were considered ordinary text).

- Fixed a bug with the "trim" options of the "unicode" directive.

* languages: Added Korean localisation (ko).

0.14

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

* docutils/docs/ref/docutils.dtd:

- Enable validation of Docutils XML documents against the DTD:

* docutils/parsers/rst/:

- Added functionality: escaped whitespace in URI contexts.
- Consistent handling of all whitespace characters in inline markup
 recognition. (May break documents that relied on some whitespace
 characters (NBSP, ...) *not* to be recognized as whitespace.)

* docutils/utils/smartquotes.py:

- Update quote definitions for et, fi, fr, ro, sv, tr, uk.
- Add quote definitions for hr, hsb, hu, lv, sh, sl, sr.
- Differentiate apostrophe from closing single quote (if possible).
- Add command line interface for stand-alone use (requires 2.7).

* docutils/writers/_html_base:

- Provide default title in metadata.
- The MathJax CDN shut down on April 30, 2017. For security reasons, we
 don't use a third party public installation as default but warn
 if `math-output` is set to MathJax without specifying a URL.
 See math-output_ for details.

* docutils/writers/html4css1:

- Respect automatic table column sizing.

* docutils/writers/latex2e/__init__.py

- Handle class arguments for block-level elements by wrapping them
 in a "DUclass" environment. This replaces the special handling for
 "epigraph" and "topic" elements.

* docutils/writers/odf_odt:

- Language option sets ODF document's default language
- Image width, scale, ... set image size in generated ODF.

* tools/

- New front-end ``rst2html4.py``.

Links

• PyPI: https://pypi.org/project/docutils
• Changelog: https://pyup.io/changelogs/docutils/
• Homepage: http://docutils.sourceforge.net/

[pyup-bot]

Closing this in favor of #309