Closed Bug 1705040 Opened 4 years ago Closed 4 years ago

[wpt-sync] Sync PR 28470 - Update docutils to 0.17

Categories

(Testing :: web-platform-tests, task, P4)

task

Tracking

(Not tracked)

RESOLVED INVALID

People

(Reporter: wpt-sync, Unassigned)

References

()

Details

(Whiteboard: [wptsync downstream])

Sync web-platform-tests PR 28470 into mozilla-central (this bug is closed when the sync is complete).

PR: https://github.com/web-platform-tests/wpt/pull/28470
Details from upstream follow.

b'pyup-bot <github-bot@pyup.io>' wrote:

Update docutils to 0.17

This PR updates docutils from 0.16 to 0.17.

<details>
<summary>Changelog</summary>

### 0.17
```
=========================
  • 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 &lt;h1&gt; and &lt;h2&gt; 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.htmlinitial-header-level
    __ https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article
    .. _embed_images: docs/user/config.htmlembed-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.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.

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

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

</details>

<details>
<summary>Links</summary>

PR 28470 applied with additional changes from upstream: 52507bc018d5f41165eeff97181fcf1b87ccb3a7
Status: NEW → RESOLVED
Closed: 4 years ago
Resolution: --- → INVALID
You need to log in before you can comment on or make changes to this bug.