Generate DITA xml from docstring

Question

I need to document my project using DITA and I'm wondering if I can use python's docstring conventions and reStructuredText to create DITA's XMLs.

Any pointers?

Answer 1

Sorry to be a bit late to this question, but I've done some work along these lines and put the resulting kit into this repository:

https://github.com/donrday/rst2dita

I hope there is something there that you or others can make use of.

Answer 2

I think what you could do is that

• You process your Python docstrings using Sphinx and its autodoc syntax

• You write custom output formatter to Sphinx which will generate DITA XML instead of HTML

Some work, but doable.