I'm the one who implemented and maintains the odf-odt writer for
Docutils.

I had a request to add support to Sphinx so that it can generate
documentation in ODF .odt documents.  That sounds like a good idea
to me.  I'm willing to do some work to make it happen.

So far, I've done the following:

1. Added options specific to the odf-odt writer in the
   QUICKSTART_CONF string in quickstart.py.

2. Created sphinx/builders/odf_odt.py

3. Created sphinx/writers/odf_odt.py -- Subclassed the Writer and
   Translator classes in docutils/writers/odf_odt/__init__.py.

4. Added new clauses etc to the MAKEFILE string in quickstart.py.

5. Registered the builder in sphinx/builders/__init__.py

Am I on the right track?

Now, I need to learn how to implement a builder.

And, I have questions:

1. What other/additional files do I need to change?

2. Does anyone have any guidance?  I've read the "Writing new
   builders" page in the Sphinx docs, but it's not particularly
   helpful to someone like me who does not understand Sphinx
   internals.  Is there a list of "essentially things any Sphinx
   builder must do"?

3. I'm trying to reverse engineer, so to speak, what is implemented
   in builders/html.py and builders/latex.py.  Are there any other
   places I can look for help, info, and guidance?

Thanks for any help.

- Dave



-- 
Dave Kuhlman
http://www.rexx.com/~dkuhlman

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to