![[ICO]](/icons/blank.gif){kind=icon}
![[DIR]](/icons/back.gif){kind=icon}
![[ ]](/icons/unknown.gif){kind=icon}
![[DIR]](/icons/folder.gif){kind=icon}
![[ ]](/icons/p.gif){kind=icon}
![[TXT]](/icons/text.gif){kind=icon}
| Name | Last modified | Size | Description |
|---|---|---|---|---|
| Parent Directory | - | ||
| MANIFEST.in | 22-Mar-2013 08:15 | 62 | |
| global.log | 22-Mar-2013 08:15 | 108K | |
| rst/ | 03-Jan-2012 12:41 | - | |
| setup.py | 22-Mar-2013 08:15 | 641 | |
| tag.log | 22-Mar-2013 08:15 | 14 | |
| tests.xalan/ | 22-Mar-2013 08:15 | - | |
| tests.xsltproc/ | 22-Mar-2013 08:15 | - | |
| tests/ | 22-Mar-2013 08:15 | - | |
| version.py | 22-Mar-2013 08:15 | 18 | |
| xml2rst.py | 22-Mar-2013 08:15 | 11K | |
| xml2rstlib/ | 22-Mar-2013 08:15 | - | |
Contents
xml2rst is a tool to generate reStructuredText syntax back from Docutils XML input. This way you can create an XML files using Docutils XML from some other format (such as ODF) and then transform the result to reStructuredText.
xml2rst is currently implemented as an XSLT stylesheet usable in three flavors:
xml2rst.py
This script uses xml2rstlib/xml2rst.xsl through the XSLT engine available through the lxml package [1]. It also uses Python callbacks for some advanced functionality.
This is the preferred method of using xml2rst but depends on the lxml package. This is also what is installed normally.
| [1] | Under Debian based operating systems try apt-get install python-lxml. |
Run xml2rst --help for information on how to run it.
xml2rstlib/xml2rst-nopy.xsl
This is the core XSLT script without using Python. It uses EXSLT and therefore needs an EXSLT capable XSLT processors such as xsltproc [2].
If you can't use xml2rst.py because you don't have lxml you may try this flavor. This version is no longer actively maintained, though.
| [2] | Under Debian based operating systems try apt-get install xsltproc. |
Run perldoc xml2rstlib/xml2rst-nopy.xsl for information on how to run it.
xml2rstlib/xml2rst-noexslt.xsl
This version can be processed with every XSLT processor like Xalan [3].
If you can use neither xml2rst.py nor xml2rst-nopy.xsl you may try this flavor. This version is no longer actively maintained, though.
| [3] | Under Debian based operating systems try apt-get install xalan. |
Run perldoc xml2rstlib/xml2rst-noexslt.xsl for information on how to run it.
xml2rst is available through the Docutils Subversion repository as part of the Docutils sandbox in sandbox/xml2rst.
Moreover you can fetch it directly from the current maintainer at http://www.merten-home.de/FreeSoftware/xml2rst/
After you obtained the package run python setup.py install.
Depending on the flavor you choose you need to install certain packages to run xml2rst.
Copyright (C) 2005, 2006 by Stefan Merten and David Priest Copyright (C) 2009, 2010, 2011 by Stefan Merten
License is GPL v2 or later.
There are test suites in tests*. Use filterunit to run tests.
xml2rst.xsl and xml2rst.py contain a couple of comments marked with TODO which contain things which should be done.
xml2rst should become a normal reStructuredText writer. Starting with V1.0 functionality is moved to a Python based implementation.