docx-xslt's Introduction

docx-xslt

docx-xslt is a Python library for adding XSL transformation for Microsoft Word .docx files without XML or XSLT coding.

The module uses Word meta text which has been formated with a specific character template called XSL, add XSL code and applies XSL transformation with the XML context.

The meta text has the following syntax:

 <meta text>        ::= <command list>
 <command list>     ::= <command expr> | <command list>
 <command expr>     ::= 'xsl' ':' <context expr> <xsl command expr> <xsl option expr>
 <context expr>     ::= ':' <context type> | 
 <context type>     ::= 'body' | 'p0' | 'p' | 'r' | 't' | 'tbl' | 'tr' | 'tc'
 <xsl command expr> ::= <meta command> | <xsl command>
 <meta command>     ::= 'meta' <meta sub command>
 <meta sub command> ::= 'up' | 'prev' | 'next' | 'cloneprev' | 'clonenext' | 'delete'
 <xsl command>      ::= 'for-each' | 'choose' | 'when' | 'otherwise' | 'if' | 'sort' | 'value-of' | 'text'
 <xsl option expr>  ::= <text> | <xsl option name> '=' <xsl option value>
 <text>             ::= ...
 <xsl option name>  ::= 'select' | 'test'
 <xsl option value> ::=  xpath expr

To insert a list of a product names, just add xsl:for-each select=.//products/* xsl:t:value-of select=name and format the text with the XSL template.

from lxml import etree
from docxxslt import DocxXsltTemplate

context = etree.parse("products.xml")
template = DocxXsltTemplate(filename)
template.save(context=context)