Restrictions

While Imprint is an extremely complex and flexible system, there are in fact certain things it can not do. The following list contains the major omissions, with a brief explanation of the underlying reasons for each one:

1. Updating the TOC: each newly generated document requires the user to right-click on the empty table of contents and manually select “Update Table”. This is necessary because calculating the page number of the headers would require a rendering engine quivalent to MS Word.

2. Header and Footer Parseability: in some cases, the XML of the Headers and Footers must be massaged manually to ensure that there are no spurious run-breaks within a keyword-replacement directive. Word will sometimes chunk up text into runs when it is not strictly necessary, resulting in the need for this manual massaging. The root cause is that the python-docx library does not currently have support for headers and footers.