docutils

package documentation
(source)

This is the Docutils (Python Documentation Utilities) package.

Package Structure

Modules:

  • __init__.py: Contains component base classes, exception classes, and Docutils version information.
  • core.py: Contains the Publisher class and publish_*() convenience functions.
  • frontend.py: Runtime settings (command-line interface, configuration files) processing, for Docutils front-ends.
  • io.py: Provides a uniform API for low-level input and output.
  • nodes.py: Docutils document tree (doctree) node class library.
  • statemachine.py: A finite state machine specialized for regular-expression-based text filters.

Subpackages:

  • languages: Language-specific mappings of terms.

  • parsers: Syntax-specific input parser modules or packages.

  • readers: Context-specific input handlers which understand the data source and manage a parser.

  • transforms: Modules used by readers and writers to modify DPS doctrees.

  • utils: Contains the Reporter system warning class and miscellaneous utilities used by readers, writers, and transforms.

    utils/urischemes.py: Contains a complete mapping of known URI addressing scheme names to descriptions.

  • utils/math: Contains functions for conversion of mathematical notation between different formats (LaTeX, MathML, text, ...).

  • writers: Format-specific output translators.

Package languages This package contains modules for language-dependent features of Docutils.
Package parsers This package contains Docutils parser modules.
Package readers This package contains Docutils Reader modules.
Package transforms This package contains modules for standard tree transforms available to Docutils components. Tree transforms serve a variety of purposes:
Package utils Miscellaneous utilities for the documentation utilities.
Package writers This package contains Docutils Writer modules.
Module core No summary
Module examples This module contains practical examples of Docutils client code.
Module frontend Command-line and common processing for Docutils front-end tools.
Module io I/O classes provide a uniform API for low-level input and output. Subclasses exist for a variety of input/output mechanisms.
Module nodes Docutils document tree element class library.
Module statemachine A finite state machine specialized for regular-expression-based text filters, this module defines the following classes:

From __init__.py:

Class ​Application​Error Undocumented
Class ​Component Base class for Docutils components.
Class ​Data​Error Undocumented
Class ​Settings​Spec Runtime setting specification base class.
Class ​Transform​Spec Runtime transform specification base class.
Class ​Version​Info Undocumented
Variable __version__ Docutils version identifier (complies with PEP 440):
Variable __version​_details__ Optional extra version details (e.g. 'snapshot 2005-05-29, r3410'). (For development and release status see __version_info__.)
Variable __version​_info__ Comprehensive version information tuple. See 'Version Numbering' in docs/dev/policies.txt.
__version__: str = (source)

Docutils version identifier (complies with PEP 440):

major.minor[.micro][releaselevel[serial]][.dev]

For version comparison operations, use __version_info__ (see, below) rather than parsing the text of __version__.

See 'Version Numbering' in docs/dev/policies.txt.

__version_info__ = (source)
Comprehensive version information tuple. See 'Version Numbering' in docs/dev/policies.txt.
__version_details__: str = (source)
Optional extra version details (e.g. 'snapshot 2005-05-29, r3410'). (For development and release status see __version_info__.)