ANN: Docutils 0.2 Released

David Goodger goodger at
Fri Aug 2 04:48:47 CEST 2002

[Resending; first time didn't get through.]

The purpose of the Docutils project is to create a set of tools for
processing plaintext documentation into useful formats, such as HTML,
XML, and TeX.  It is the subject of PEPs 256 & 258.  Docutils
currently supports input from standalone files and PEPs; the emphasis
for release 0.3 will be support for inline documentation from Python
modules and packages.  Docutils uses the reStructuredText markup, the
subject of PEP 287; but other markups are possible.  It currently
produces simple HTML for CSS and Docutils-native XML.  PDF and DocBook
XML are under development, and other formats will become available in

Quick link to the download:

Docutils home page:

There have been many improvements since release 0.1:

* The front-end tools have increased in number and now have support
  for command-line options (thanks to Greg Ward's Optik) and
  configuration files.

* Added PEP processing (see
  for an example).  Under consideration by PythonLabs and Python-Dev
  for use.

* Added a new "simple tables" construct to reStructuredText.

* Improved the generated HTML.  Now XHTML-compatible.  Improved
  stylesheet support

* Unicode and input/output encoding support.

* Swedish and German output support (boilerplate translations; thanks
  to Adam Chodorowski and Gunnar Schwant).

* Lots of internal improvements.

To subscribe to the mailing lists:

* Development discussions (docutils-develop at

* CVS checkin messages:

High-level discussions take place on the Python Doc-SIG mailing list:,
mailto:Doc-SIG at

User documentation:

* A ReStructuredText Primer (gentle introduction):

* Quick reStructuredText (user reference):

* Docutils Front-End Tools:

Further details here:

* Docutils README:

* Docutils History:

* Copying Docutils:

There is still much work to be done.  Contributors are welcome!

David Goodger  <goodger at>  Open-source projects:
  - Python Docutils:
    (includes reStructuredText:
  - The Go Tools Project:

More information about the Python-list mailing list