docxbuilder 1.2.0

Sphinx docx builder extension

Docxbuilder is a Sphinx extension to build docx formatted documents.

Note

This extension is developed based on sphinx-docxbuilder. Though, there is no compatibility between these extensions.

Requirements

Python:	2.7, 3.5 or latter
Sphinx:	1.7.6 or later

Install

Use pip:

pip install docxbuilder

Usage

Add ‘docxbuilder’ to extensions configuration of conf.py:

extensions = ['docxbuilder']

and build your documents:

make docx

You can control the generated document by adding configurations into conf.py:

docx_documents = [
    ('index', 'docxbuilder.docx', {
         'title': project,
         'creator': author,
         'subject': 'A manual of docxbuilder',
     }, True),
]
docx_style = 'path/to/custom_style.docx'
docx_pagebreak_before_section = 1

For more details, see the documentation.

Style file

Generated docx file’s design is customized by a style file (The default style is docxbuilder/docx/style.docx). The style file is a docx file, which defines some paragraph, character, and table styles.

The below lists shows typical styles.

Character styles:

• Emphasis
• Strong
• Literal
• Hyperlink
• Footnote Reference

Paragraph styles:

• Body Text
• Footnote Text
• Definition Term
• Literal Block
• Image Caption, Table Caution, Literal Caption
• Heading 1, Heading 2, …, Heading N
• TOC Heading
• toc 1, toc 2, …, toc N
• List Bullet
• List Number

Table styles:

• Table
• Field List
• Admonition Note

TODO

• Support math role and directive.
• Support tabular_col_spec directive.
• Support URL path for images.

Licence

MIT Licence