Docutils Release Notes

Future changes

Release 1.0b1.dev (unpublished)

Document Tree / Docutils DTD:

• Drop the name attribute from <reference> nodes.

Configuration changes:

• Auto-detection of the input encoding is no longer supported. The input_encoding value None now stands for "utf-8", the empty string now leads to a LookupError.

• The section_self_link setting now defaults to True.

• The use_latex_citations setting now defaults to True.

• The legacy_column_widths setting now defaults to False.

• The initial_header_level setting default for the HTML5 writer changed to "auto".

Command line interface:

• Option -o sets the output file path (shortcut for --output).

• Drop the <destination> positional argument. Use -o <destination> or output redirection.

HTML5 writer:

• Use normal font size and colour for informal titles of type "rubric".

• Use more specific CSS selectors for styling <aside> elements as topic, sidebar, admonition, or system-message.

LaTeX writer:

• Change the default length unit from "bp" (DTP point) to "px".

New objects:

transforms.references.MatchReferences

transforms.references.ReportDanglingReferences

transforms.references.ReportUnreferencedLinks

replacements for transforms.references.DanglingReferences.

Removed objects:

core.publish_cmdline_to_binary()

Use core.publish_cmdline() (works with bytes since Docutils 0.20).

io.BinaryFileOutput

Use io.FileOutput (works with bytes since Docutils 0.20).

io.Input.byte_order_marks

io.Input.coding_slug

io.Input.successful_encoding

io.Input.determine_encoding_from_data()

No longer required as encoding detection is dropped.

nodes.Targetable.indirect_reference_name

Internal attribute for the Python-2-only MoinMoin <= 1.9.

parsers.recommonmark_wrapper

Wrapper module for the no longer maintained 3rd party recommonmark parser. See the parser setting documentation for alternatives.

parsers.rst.directives.CSVTable.HeaderDialect

deprecated since Docutils 0.20.

parsers.rst.directives.length_units

Use the tuple parsers.rst.directives.CSS3_LENGTH_UNITS.

Transformer.unknown_reference_resolvers

TransformSpec.unknown_reference_resolvers

Unknown references can be solved in a transform, see transforms.references.CitationReferences for an example.

utils.decode_path()

Not required with Python 3.

utils.get_stylesheet_reference()

Use utils.get_stylesheet_list().

writers.latex2e.LaTeXTranslator.visit_docinfo_item() "name" argument

writers.latex2e.SortableDict

Not used and deprecated since Docutils 0.22.

Release 0.23 (2026-05-27)

General:

• Define public API and backwards compatibility policy.

rST parser:

• Problems with the "include" directive are reported as ERROR, not SEVERE.

• The "include" directive options :start-after: and :end-before: may now also be used without value (standing for an empty line).

• The highlight language of a custom role based on the "code" role defaults to the role's name (if supported by Pygments). Specifying :language: none turns off syntax highlight.

HTML5 writer:

• If a section has several IDs, use the last one (from the first preceding explicit target) as section_self_link.

LaTeX writer:

• Do not write \label commands for section titles and other implicit targets if there is no matching reference in the document.

• Support semantic inline markup roles.

Configuration changes:

• New setting legacy_ids (provisional).

• The new setting latex_footnotes replaces "docutils_footnotes" (ignored since Docutils 0.13.1). The command line option --docutils-footnotes is kept and sets latex_footnotes to False.

New objects:

nodes.document.names:

Internal attribute mapping reference names to the referenced elements (or None if the name is a duplicate).

nodes.document.note_names():

Register an element's reference name(s), check for duplicates.

nodes.document.set_duplicate_name()

Called by nodes.document.note_names() to handle duplicate names. Provisional.

transforms.SectionIDs:

Ensure all sections have an identifier.

Removed objects:

parsers.rst.directives.tables.CSVTable.check_requirements()

not required with Python 3.

nodes.document.set_duplicate_name_id()

internal method, replaced by nodes.document.set_duplicate_name().

Release 0.22.4 (2025-12-18)

reStructuredText Specification:

• Clarify indentation rules: minimal indentation is one space.

• Clarify comment syntax: Comments begin with two dots and whitespace.

HTML writers:

• New value "auto" for the initial_header_level setting.

• Bugfixes in the provisional style-sheet "responsive.css".

See HISTORY for details.

Release 0.22.3 (2025-11-06)

rST parser:

• Ignore combining characters when parsing the grid table structure.

• Allow for auxiliary elements like sphinx.addnodes.only when testing for invalid parents of topics or sidebars.

Release 0.22.2 (2025-09-20)

Remove a spurious vim .swp-file.

Release 0.22.1 (2025-09-17)

rST parser:

• Relax "section title" system messages from SEVERE to ERROR.

• New attribute parsers.rst.states.NestedStateMachine.parent_state_machine.

LaTeX writer:

• Add cross-reference anchors (\phantomsection\label{...}) for elements with IDs (fixes bug #503).

• Fix cross-reference anchor placement in figures, images, literal-blocks, tables, and (sub)titles.

and improvements (see HISTORY).

Release 0.22 (2025-07-29)

reStructuredText:

• Support CSS3 units. This adds "ch", "rem", "vw", "vh", "vmin", "vmax", and "Q" to the supported length units. Note that some output formats don't support all units.

• New option "figname" for the "figure" directive.

• Targets generated from hyperlink references with embedded URI or alias are no longer "explicit" but "implicit" (i.e. with the same priority as auto-generated section targets, see implicit hyperlink targets).

• Don't report an error for duplicate targets with identical refname.

• Drop the "name" option of the "target-notes" directive. (Report an error instead of silently ignoring the value.)

• New alias "rst-class" for the "class" directive to improve the compatibility with Sphinx.

Document Tree / Docutils DTD:

• Allow multiple <term> elements in a <definition_list_item> (third-party writers may need adaption).

• The first element in a <figure> may also be a <reference> (with nested "clickable" <image>).

Configuration changes:

• Make MathML the default math_output for the "html5" writer.

• Change the default input_encoding from None (auto-detect) to "utf-8".

• Drop short options -i and -o. Use the long equivalents --input-encoding and --output-encoding. (See command line interface for the rationale.)

• Rename configuration setting "output" to "output_path".

• New setting "validate".

• The manpage writer now recognizes the sections [writers] and [manpage writer] with the new setting text_references.

Output changes

LaTeX:

Don't wrap references with custom reference_label in a \hyperref command. The "hyperref" package generates hyperlinks for labels by default, so there is no change in the PDF (except for the starred forms like reference_label = \ref*).

Stop requiring "ifthen.sty". Add "ifthen" to the stylesheet setting or replace use of \ifthenelse{\isundefined... with the eTeX primitive \ifdefined.

HTML5:

Unitless image size measures are written as <img> "width" and "hight" values instead of "style" rules. The current behaviour is kept for values with units, so users may specify, e.g. :width: 50px instead of :width: 50 to override CSS stylesheet rules.

manpage:

Don't UPPERCASE section headings.

Handle hyperlink references (see the text_references setting).

null:

The "null" writer output changed from None to the empty string.

publish_string() now returns a bytes or str instance for all writers (as documented).

New objects

parsers.docutils_xml

parser for Docutils XML (e.g., the output of the "xml" writer). Provisional.

Try docutils --parser=xml test/data/multiple-term-definitions.xml or use the :parser: option of the "include" directive to include an XML file in a rST document.

nodes.Element.validate()

Raise nodes.ValidationError if the element does not comply with the Docutils Document Model. Provisional.

transforms.references.CitationReferences

Mark citation_references as resolved if the backend uses a BibTeX database.

writers.DoctreeTranslator

Generic Docutils document tree translator base class with uri2path() auxiliary method. Provisional.

Removed objects:

core.Publisher.setup_option_parser()

internal, obsolete,

frontend.ConfigParser.get_section()

obsoleted by the configparser's "Mapping Protocol Access",

frontend.OptionParser.set_defaults_from_dict()

obsolete,

nodes.Element.set_class()

obsolete, append to Element['classes'] directly,

parsers.rst.directives.tables.CSVTable.decode_from_csv()

not required with Python 3,

parsers.rst.directives.tables.CSVTable.encode_from_csv()

not required with Python 3,

transforms.writer_aux.Compound

not used since Dec 2010,

utils.error_reporting

obsolete in Python 3,

utils.Reporter.set_conditions()

obsolete, set attributes via configuration settings or directly.

Removed localisations:

Mistranslations of the "admonition" directive name:

Use "advies" (af), "varsel" (da), "warnhinweis" (de), "aviso" (es), "sciigo" (eo), "annonce" (fr), "avviso" (it), "advies" (nl), "zauważenie" (pl) (introduced in Docutils 0.21) or the English name "admonition".

New files:

docutils/parsers/rst/include/html-roles.txt

Standard definition file for additional roles matching HTML tags.

Removed files:

tools/rst2odt_prepstyles.py

Obsoleted by writers.odf_odt.prepstyles.

docutils/utils/roman.py

Obsoleted by docutils/utils/_roman_numerals.py

Bugfixes and improvements (see HISTORY).

Release 0.21.2 (2024-04-23)

• Document Tree / Docutils DTD

  • Remove declaration of unsupported element <info>.

  • Remove <decoration> from content declaration of <section> elements.

• Declare support for languages Georgian and Catalan (Valencian).

• Fix test failures.

Release 0.21.1 (2024-04-10)

Add missing metadata files to sdist. No changes to the code.

Release 0.21 (2024-04-09)

• General:

  • Drop support for Python 3.7 and 3.8.

  • Provide rst2* "console_scripts" entry points (without the .py extension) instead of installing the rst2*.py front end tools in the binary PATH. [3]

    Exceptions: rstpep2html.py and rst2odt_prepstyles.py:

    • Use docutils --reader=pep --writer=pep_html for a PEP preview. [4]

    • Use python -m docutils.writers.odf_odt.prepstyles to strip the page size from an ODT writer stylesheet.

• reStructuredText:

  • Use the same CSV format for the :header: option and the main data of the "csv-table" directive.

  • New option "loading" for the "image" directive. Sets the new attribute loading of the <image> doctree element.

• Configuration changes:

  • New configuration setting root_prefix. Configurable root directory for included files.

  • New configuration setting sources for the "buildhtml.py" application.

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

• Output changes:

  HTML5:

  Stop setting the "footnote-reference" class value for footnote references. Use the CSS selector [role="doc-noteref"] (works since Docutils 0.18, see minimal.css for examples).

  Fix MathML rendering problems in Chrome/Chromium based browsers.

  Embed SVG images as <svg> instead of data-URI.

  manpage:

  Use .EE/.EX macros for literal blocks.

  Render URI references (do not use .UR/.UE).

  Use box option for tables.

• Removed objects:

  nodes.reprunicode, nodes.ensure_str()

  Python 2 compatibility hacks

  utils.Reporter.set_conditions()

  obsolete

  writers.latex2e.Table.get_caption

  obsolete

• New files:

  docutils/writers/html5_polyglot/italic-field-names.css

  Alternative style for Docutils field-lists.

• Removed files:

  install.py, setup.py

  Metadata is now stored in pyproject.toml, supported by pip since version 19.0 (2019-01-22). See README for installation alternatives.

• Bugfixes and improvements (see HISTORY).

Release 0.20.1 (2023-05-17)

Bugfix release. See HISTORY for details.

Release 0.20 (2023-05-04)

• General

  • Support Python 3.11 (patch #198 by Hugo van Kemenade).

• Output changes:

  HTML5:

  Use dpub-ARIA role "doc-footnote" (instead of ARIA role "note") for footnotes.

  LaTeX:

  Do not load the inputenc package in UTF-8 encoded LaTeX sources. (UTF-8 is the default encoding for LaTeX2e since 2018).

• Configuration changes:

  • Settings in the [latex2e writer] configuration file section are now ignored by the "xetex" writer. Place common settings in section [latex writers].

  • New configuration setting "output". Obsoletes the <destination> positional argument.

• utils.find_file_in_dirs() now returns a POSIX path also on Windows; utils.get_stylesheet_list() no longer converts \ to /.

• docutils/languages/ docutils/parsers/rst/languages/

  • Support Ukrainian. Patch by Dmytro Kazanzhy.

• test/coverage.sh

  • Removed. Use the coverage.py project instead, coverage run test/alltests.py and coverage report.

• tools/

  • Moved quicktest.py to tools/dev/.

• Bugfixes and improvements (see HISTORY).

Release 0.19 (2022-07-05)

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

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

Release 0.18.1 (2021-12-23)

• 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 its 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" now gets the identifier key DU-34-may instead of DU-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.

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

Release 0.17.1 (2021-04-16)

• Bug fixes (for details see the Docutils HISTORY).

Release 0.17 (2021-04-03)

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

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

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

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

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

Release 0.16 (2020-01-12)

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.

• 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" (deprecated in favour of the "writer" setting in Docutils 0.18).

• docutils/io.py

  • Remove the handle_io_errors argument from io.FileInput/Output.

• docutils/nodes.py

  • If auto_id_prefix ends with "%", this is replaced with the tag name.

• Various bugfixes and improvements (see HISTORY).

Release 0.15 (2019-07-20)

Docutils 0.15.x is compatible with Python versions 2.6, 2.7 and 3.3 to 3.5.

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

Release 0.14 (2017-08-03)

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

Release 0.13.1 (2016-12-09)

• docutils/writers/html5_polyglot

  • New HTML writer generating HTML 5.

• tools/

  • New front-end rst2html5.py.

• languages: persian/farsi (fa) and latvian (la) mappings.

• change default base url for :rfc: to http://tools.ietf.org/html/

• tables accept widths, a list and align

• latex2e: Fix admonition width, remove deprecated options, better tablewidth auto, ...

• rst.el: The problem with electric-indent-mode has been fixed.

Release 0.12 (2014-07-06)

Small changes only, release current state

Release 0.11 (2013-07-22)

• General

  • Apply [ 2714873 ] Fix for the overwriting of document attributes.

  • Support embedded aliases within hyperlink references.

  • Fix [ 228 ] try local import of docutils components (reader, writer, parser, language module) before global search.

• docutils/parsers/rst/directives/tables.py

  • Fix [ 210 ] Python 3.3 checks CVS syntax only if "strict" is True.

• docutils/writers/html4css1/__init__.py - Fix [ 3600051 ] for tables in a list, table cells are not compacted. - New setting stylesheet_dirs (see above).

  Now, it is easy to add a custom stylesheet to Docutils' default stylesheet with, e.g., --stylesheet_path='html4css1.css, mystyle.css'

  Changed behaviour of the default settings:

  if there is a file html4css1.css in the working directory of the process at launch, it is used instead of the one provided by Docutils in the writer source directory.

  • New default for math_output: HTML math.css.

  • Avoid repeated class declarations in html4css1 writer (modified version of patch [ 104 ]).

• docutils/writers/latex2e/__init__.py

  • Drop the simple algorithm replacing straight double quotes with English typographic ones. Activate the SmartQuotes transform if you want this feature.

  • New setting stylesheet_dirs: Comma-separated list of directories where stylesheets are found. Used by stylesheet_path when expanding relative path arguments.

• docutils/writers/manpage.py

  • Fix [3607063] handle lines starting with a period.

  • Fix option separating comma was bold (thanks to Bill Morris).

Release 0.10 (2012-12-16)

Docutils 0.10 is compatible with Python versions from 2.4 to 3.2.

• General:

  • SmartQuotes transform for typographic quotes and dashes.

  • docutils/math, docutils/error_reporting.py, and docutils/urischemes.py moved to the utils package. Code importing these modules needs to adapt, e.g.:

    try:
        import docutils.math as math
    except ImportError:
        import docutils.utils.math as math

  • enhanced math and error handling.

• docutils/io.py

  • FileInput/FileOutput: no system-exit on IOError. The handle_io_errors argument is ignored.

• docutils/writers/html4css1/__init__.py

  • Use <code> tag for inline "code", do not drop nested inline nodes (syntax highlight tokens).

  • Customizable MathJax URL (based on patch by Dmitry Shachnev).

  • No line break after opening inline math tag.

• docutils/writers/latex2e/__init__.py, docutils/writers/xetex/__init__.py

  • Fix section numbering by LaTeX.

• docutils/writers/s5_html/__init__.py

  • Fix [ 3556388 ] Mathjax does not work with rst2s5.

Release 0.9.1 (2012-06-17)

• General:

  Several fixes for Python 3 usage.

• docutils/setup.py

  • Fix [ 3527842 ]. Under Python 3, converted tests and tools were installed in the PYTHONPATH. Converted tests are now stored in docutils/test3/, tools no longer need conversion.

    If you installed one of Docutils versions 0.7 ... 0.9 with setup.py install under Python 3, remove the spurious test/ and tools/ directories in the site library root.

Release 0.9 (2012-05-02)

• General:

  • reStructuredText "code" role and directive with syntax highlighting by Pygments.

  • "code" option of the "include" directive.

  • Fix [ 3402314 ] allow non-ASCII whitespace, punctuation characters and "international" quotes around inline markup.

  • Fix handling of missing stylesheets.

• setup.py

  • Fix [ 2971827 ] and [ 3442827 ] extras/roman.py moved to docutils/utils/roman.py

• docutils/utils.py -> docutils/utils/__init__.py

  • docutils.utils is now a package (providing a place for sub-modules)

• docutils/writers/html4css1/__init__.py

  • change default for math-output setting to MathJax

• docutils/writers/latex2e/__init__.py

  • Support the abbreviation and acronym standard roles.

  • Record only files required to generate the LaTeX source as dependencies.

  • Use \setcounter{secnumdepth}{0} instead of *-versions when suppressing LaTeX section numbering.

Release 0.8.1 (2011-08-30)

• General:

  • Fix [ 3364658 ] (Change last file with Apache license to BSD-2-Clause) and [ 3395920 ] (correct copyright info for rst.el).

• docutils/writers/latex2e/__init__.py

  • Clean up Babel language setting. Restores Sphinx compatibility.

Release 0.8 (2011-07-07)

• COPYING:

  • Some additions to the Docutils core are released under the 2-Clause BSD license.

• General:

  • Handle language codes according to BCP 47.

  • If the specified language is not supported by Docutils, warn and fall back to English.

  • Math support: reStructuredText "math" role and directive, math and math_block doctree elements.

  • Orphaned "python" reader and "newlatex2e" writer moved to the sandbox.

• reStructuredText:

  • most directives now support a "name" option that attaches a reference name. So you can write

    .. image:: image.png
       :name: image name

    as a short form of

    .. _image name:
    
    .. image:: image.png

Internationalization:

• Added Lithuanian mappings.

Components:

• HTML writer:

  • New setting "math-output" with support for HTML, MathML, and LaTeX.

• LaTeX2e writer:

  • Convert image URI to a local file path.

  • Apply [ 3148141 ] fix multicolumn support when a colspanning cell has more than one paragraph (Wolfgang Scherer).

• XeTeX writer:

  • New writer generating LaTeX code for compiling with xelatex.

    XeTeX uses unicode and modern font technologies.

• and fixes and enhancements here and there.

Release 0.7 (2010-07-07)

Components:

• HTML writer:

  • Support SVG and SWF images (thanks to Stefan Rank).

  • Generate valid XHTML for centered images with targets. Use CSS classes instead of "align" tags for image alignment.

• LaTeX2e writer:

  • Use the \url command for URLs (breaks long URLs instead of writing into the margin).

  • Preserve runs of spaces in 'inline literals'.

  • Deprecate figure_footnotes setting.

  • Rename use_latex_footnotes setting to docutils_footnotes.

  • New latex_preamble setting.

  • Use PDF standard fonts (Times/Helvetica/Courier) as default.

  • hyperref package called with unicode option (see the hyperref config tips for how to override).

  • Drop the special output_encoding default ("latin-1"). The Docutils wide default (usually "UTF-8") is used instead.

• manpage writer:

  • Titles level 1, that is .SH, always uppercase.

  • Apply patch from mg: literal text should be bold in man-pages.

General:

• io.FileInput opens files as text files with universal newline support (mode "rU", configurable with the new optional argument "mode").

• setup.py:

  • Python 3 support: copy test/ and tools/ to the build-dir and convert Python sources with 2to3.

Release 0.6 (2009-10-11)

Docutils 0.6 is compatible with Python versions from 2.3 up to 2.6 and convertible to 3.1 code.

• reStructuredText:

  • Allow length units for all length specifications.

  • Allow percent sign in "scale" option of "figure" and "image" directives.

  • Align images with class "align-[right|center|left]" (allows setting the alignment of an image in a figure).

  • Hard tabs in literal inclusions are replaced by spaces. This is configurable via the new :tab-width: option of the "include" directive (a negative tab-width prevents tab expansion).

• HTML writer:

  • --stylesheet and --stylesheet-path options now support a comma separated list of stylesheets.

• LaTeX2e writer:

  • New defaults: - font-encoding: "T1" (formerly implicitly set by 'ae'). - use-latex-toc: true (ToC with page numbers). - use-latex-footnotes: true (no mixup with figures). - Float placement defaults to "here definitely" (configurable). - Align of image in a figure defaults to 'center'. - Use class defaults for page margins ('typearea' now optional).

  • Support LaTeX packages as --stylesheet arguments.

  • Use bp for lengths without unit or unit pt, do not convert px to pt.

  • Do not use 'ae' and 'aeguill' packages if font-encoding is set to ''.

  • Set sub- and superscript role argument as text not math.

  • Support custom roles based on standard roles.

  • Load packages and define macros only if required in the document.

  • All Docutils specific LaTeX macros are prefixed with DU.

  • Better conformance to Docutils specifications with "use_latex_toc".

  • If 'sectnum_xform' is False, the 'sectnum' directive triggers section numbering by LaTeX.

  • Use default font in admonitions and sidebar.

  • Typeset generic topic as "quote with title".

  • Use template (file and configuration option).

  • Render doctest blocks as literal blocks (indented).

  • Bugfix: The "align" argument of a figure now works as documented (aligning the figure, not its contents).

• ODT writer:

  • moved from sandbox to Doctutils core.

• manpage writer:

  • moved from sandbox to Doctutils core.

Release 0.5 (2008-06-25)

Components:

• HTML writer.

  • Dropped all name attributes of a elements (id is universally supported now).

• LaTeX2e writer:

  • Better bibTeX citation support.

  • Add --literal-block-env

• PEP writer:

  • Changed to support new python.org website structure and pep2pyramid.py.

reStructuredText:

• Changed the directive API to a new object-oriented system. (Compatibility for the old, functional-style directive interface is retained.) See the updated Creating reStructuredText Directives how-to.

• Allow + and : in reference names requested for citations.

Documentation:

• Added Deploying Docutils Securely

Internationalization:

• Added hebrew mappings.

General:

• Configuration files are now assumed and required to be UTF-8-encoded.

• Added docutils/writers/html4css1/template.txt.

• Enhance emacs support.

Release 0.4 (2006-01-09)

Components:

• Added an S5/HTML writer and the rst2s5.py front end: multi-platform, multi-browser HTML slide shows.

• The newlatex2e writer is nearing completion.

• Added a DocTree reader, publish_doctree and publish_from_doctree convenience functions, for document tree extraction and reprocessing.

reStructuredText:

• Added directives: "container" (generic block-level container), "default-role" (role used for `backtick` syntax), "title" (document title metadata), and "date" (generate the current local date, for substitution definitions).

• Length units are now supported for image sizes.

• Added standard definition files for special characters etc.

Internationalization:

• Added Japanese and Simplified Chinese language mappings, and support for double-width CJK-characters in tables and section titles.

Documentation:

• Added a guide for distributors (package maintainers) and a guide for developers.

General:

• Added significant Emacs support for reST.

• Added a --strip-comments option.

• --embed-stylesheet is now the default for the HTML writer (rather than --link-stylesheet).

Release 0.3.9 (2005-05-26)

• Added "file_insertion_enabled" and "raw_enabled" settings.

• Added auto-enumerated lists.

• Added "header" and "footer" directives.

• Added "list-table" directive.

• Added support for section subtitles.

• Added "field_name_limit" and "option_limit" settings to HTML writer.

• Added "cloak_email_addresses" setting to HTML writer.

• UTF-8 BOMs are now removed from the input stream.

Release 0.3.7 (2004-12-24)

• A special "line block" syntax has been added. (Also see the quick reference.)

• Empty sections are now allowed.

• A "raw" role has been added.

• The LaTeX writer now escapes consecutive dashes (like "--" or "---") so that they are no longer transformed by LaTeX to en or em dashes. (Please see the FAQ for how to represent such dashes.)

• A dependency recorder has been added.

• A directive has been added for compound paragraphs.

Release 0.3.5 (2004-07-29)

• Improved, extended and reorganized the documentation.

• Added "csv-table" directive.