Sphinx docx builder extension generate single docx file from Sphinx document source. This extension use python-docx module (included) for the docx file generation.
This extension work on Multi-platform (not need OpenOffice or MS Word).
Currently, many directives and indented block are not work correctly, yet.
‘hg clone’ or download sphinxcontrib-docxbuilder archive from ‘get source’ menu at http://bitbucket.org/shimizukawa/sphinxcontrib-docxbuilder
$ cd /path/to/sphinxcontrib-docxbuilder $ python bootstrap.py -d init $ bin/buildout
for example sphinx-docx building, simply run below:
$ bin/example ... 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] $ ls [output-dir] output.docx
toctree generation (dispose toctree output? create by docx function?)
reset number for non-continuous numbered list
add page-break directive
using dotx template
some emphasis (italic, bold)
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)
TODO: Figure out how to actually get changelog content.
Changelog content for this version goes here.