Index of /sandbox/odf2docutils

[ICO]NameLast modifiedSizeDescription

[DIR]Parent Directory  -  
[   ]MANIFEST.in03-Aug-2013 12:14 78  
[TXT]odf2docutils.py03-Jan-2014 10:15 5.5K 
[DIR]tests/03-Jan-2014 10:16 -  
[   ]global.log03-Jan-2014 10:16 68K 
[TXT]odf2docutils.rst03-Jan-2014 10:16 1.1K 
[DIR]odf2docutilslib/03-Jan-2014 10:16 -  
[   ]setup.py03-Jan-2014 10:16 555  
[   ]tag.log03-Jan-2014 10:16 19  
[DIR]tests.xslt/03-Jan-2014 10:16 -  
[   ]version.py03-Jan-2014 10:16 18  

odf2docutils

odf2docutils

Contents

What is odf2docutils?

odf2docutils is a tool to generate Docutils XML from Open Document Format (ODF). This way you can create a Docutils XML file from ODF input and then transform the result to reStructuredText by using xml2rst.

Using odf2docutils

Use odf2docutils by calling odf2docutils.py on an ODF file. Run odf2docutils --help for more information.

Availability

odf2docutils is available through the Docutils Subversion repository as part of the Docutils sandbox in sandbox/odf2docutils.

Moreover you can fetch it directly from the current maintainer at http://www.merten-home.de/FreeSoftware/odf2docutils/

Installation

odf2docutils depends on the lxml package [1]. Make sure this package is installed before running odf2docutils.

After you obtained the package run python setup.py install.

[1]Under Debian based operating systems try apt-get install python-lxml.

Development

Tests

There are test suites in tests. Use filterunit to run tests.

ToDos

So far only a small subset of ODF is supported. This may change over time.

Implementation

The core of odf2docutils is implemented as an XSLT stylesheet called odf2docutils.xsl. So far the script odf2docutils.py is only needed for handling ODF files and run the XSLT processor.