Sphinx docx builder extension generate single docx file from Sphinx document source. The sphinxcontrib-docxbuilder extension uses the python-docx module (included) for the docx file generation.
Currently, many directives and indented block are not work correctly, yet.
Make environment by buildout
'hg clone' or download sphinxcontrib-docxbuilder archive from 'get source' menu at http://bitbucket.org/shimizukawa/sphinxcontrib-docxbuilder
python bootstrap.py -d init
for example sphinx-docx building, simply run below:
Saved new file to: examples/example-0.1.docx
Set 'sphinxcontrib-docxbuilder' to 'extensions' line of target sphinx source conf.py:
extensions = ['sphinxcontrib-docxbuilder']
Execute sphinx-build with below option:
bin/sphinx-build -b docx [input-dir] [output-dir]
- some indented block output are not working correctly yet.
- figure directive's caption become normal paragraph (not bundled with image).
- python-docx using template's media(image) folder for temporarily, then some independent document's media files are shared unexpectly.
- image directive break docx format (maybe very large file are included)