=====================
 Docutils_ Link List
=====================

:Author: Felix Wiemann
:Contact: Felix.Wiemann@ososo.de
:Revision: $Revision$
:Date: $Date$
:Copyright: This document has been placed in the public domain.

.. contents::

This document contains links users of Docutils and reStructuredText
may find useful, listed in no particular order.  Many of the project
listed here are hosted in the `Docutils Sandbox`_.  If you have
something to publish, you can get write access, too!

The most current version of this link list can always be found at
http://docutils.sourceforge.net/docs/user/links.html.


Users
-----

This section contains links which are interesting for all users of
Docutils.  All projects listed here are usable by end users in some
way, however please do not expect all of them to run straight out of
the box.

* For Wikis, please see the `FAQ entry about Wikis`_.

* For Blogs (Weblogs), please see the `FAQ entry about Blogs`_.

* xml2rst_, an XSLT stylesheet written by Stefan Merten, converts XML
  dumps of the document tree (e.g. created with rst2xml.py) back to
  reStructuredText.

* rst2ht_, by Oliver Rutherfurd, converts reStructuredText to an .ht
  template, for use with ht2html_.

* htmlnav_, by Gunnar Schwant, is an HTML writer which supports
  navigation bars.

* xhtml2rest_, written by Antonios Christofides, is a simple utility
  to convert XHTML to reStructuredText.

* rst2chm_, written by Oliver Rutherfurd, generates Microsoft HTML
  Help files from reStructuredText files.

* rest2web_, by Michael Foord, is a tool for creating web sites with
  reStructuredText.

* ZReST_, by Richard Jones, is a "ReStructuredText Document for Zope"
  application that is complete and ready to install.

* The Docutils interface to PythonPoint_, also by Richard Jones,
  produces PDF presentations using ReportLabs.

* Engelbert Gruber has begun a `ManPage Writer`_.

* Oliver Rutherfurd has begun a `DocBook Writer`_.

* Gunnar Schwant's DocFactory_ is a wxPython GUI application for
  Docutils.

* Patrick O'Brien has taken over the `OpenOffice.org Writer`_.

* Bill Bumgarner has written a `simple HTML writer`_ that doesn't rely
  on CSS (stylesheets).

* Beni Cherniavsky has written a generic `preprocessing module`_ for
  roles and/or directives and built preprocessors for TeX math for
  both LaTeX and HTML output on top of it.

* Beni Cherniavsky maintains a Makefile_ for driving Docutils, hoping
  to handle everything one might do with Docutils.


API Developers
--------------

This section contains links which are primarily interesting for
developers who use the Docutils API from within their own
applications.

* Nabu_, written by Martin Blais, is a publishing system which
  extracts information from reStructuredText documents and stores it
  in a database.  Python knowledge is required to write extractor
  functions (see `Writing an Extractor`_) and to retrieve the data
  from the database again.

* There is a `pickle writer`_, written by Martin Blais.


Core Developers
---------------

Links primarily interesting for developers who work with the Docutils
code base.

* PySource_, by Tony Ibbs, is an experimental Python source Reader.
  There is some related code in David Goodger's sandbox
  (pysource_reader_) and a `Python Source Reader`_ document.


.. _Docutils: http://docutils.sourceforge.net/
.. _FAQ entry about Wikis: http://docutils.sf.net/FAQ.html#are-there-any-wikis-that-use-restructuredtext-syntax
.. _FAQ entry about Blogs: http://docutils.sf.net/FAQ.html#are-there-any-weblog-blog-projects-that-use-restructuredtext-syntax
.. _xml2rst: http://www.merten-home.de/FreeSoftware/xml2rst/index.html
.. _rst2ht: http://www.rutherfurd.net/articles/rst-ht2html.html
.. _ht2html: http://ht2html.sourceforge.net/
.. _htmlnav: http://docutils.sf.net/sandbox/gschwant/htmlnav/
.. _xhtml2rest: http://docutils.sf.net/sandbox/felixwiemann/xhtml2rest/
.. _rst2chm: http://www.rutherfurd.net/software/rst2chm/
.. _rest2web: http://www.voidspace.org.uk/python/rest2web/
.. _Docutils Sandbox: http://docutils.sf.net/sandbox/README.html
.. _ZReST: http://docutils.sf.net/sandbox/richard/ZReST/
.. _PySource: http://docutils.sf.net/sandbox/tibs/pysource/
.. _pysource_reader: http://docutils.sf.net/sandbox/davidg/pysource_reader/
.. _Python Source Reader: http://docutils.sf.net/docs/dev/pysource.html
.. _PythonPoint: http://docutils.sf.net/sandbox/richard/pythonpoint/
.. _Manpage Writer: http://docutils.sf.net/sandbox/grubert/man/
.. _ReportLabs/PDF Writer: http://docutils.sf.net/sandbox/dreamcatcher/rlpdf/
.. _DocBook Writer: http://docutils.sf.net/sandbox/oliverr/docbook/
.. _DocFactory: http://docutils.sf.net/sandbox/gschwant/docfactory/doc/
.. _OpenOffice.org Writer: http://docutils.sf.net/sandbox/pobrien/OpenOffice/
.. _simple HTML writer: http://docutils.sf.net/sandbox/bbum/DocArticle/
.. _preprocessing module: http://docutils.sf.net/sandbox/cben/rolehack/
.. _Makefile: http://docutils.sf.net/sandbox/cben/make/
.. _Nabu: http://furius.ca/nabu/
.. _Writing an Extractor: http://furius.ca/nabu/doc/nabu-extractor.html
.. _pickle writer: http://docutils.sf.net/sandbox/blais/pickle_writer/