Forum OpenACS Q&A: Re: New package documentation
I've found a way out, however, namely W2XML, a thing that can convert Word documents to XML using a specific stylesheet, most notably DocBook.
So now I can use MS Word to write the doc, then convert it to DocBook. Neat. (Thanks, Mark, for the tip.)
Now the problem is that that converter only uses <section> tags, and not the <sect1>, <sect2>, etc., tags, that we tend to use.
Checking the reference at
it's clear that this should be just as fine. However, using our setup, each section gets the same size header, and the table of contents doesn't work.
Anybody have any idea why that would be and how to fix it?
It is very simple to modify the Docbook XSLT in W@XML to make <sect1> vs <section> tags. Simply modify the XSLT. Changing the section tags to sect1 tags is easy. Simply replace the following:
You may have to add a named style in word to pick up nested "sections", and detect this as a class attribute in the exported XML. For example, if you wanted to capture a style named "Heading4ArialNarrow" as your sect2's, then add the following to the Docbook XSLT:
<xsl:template match="h:p[attribute::class = 'Heading4ArialNarrow']">
The standard output from W2XML captures each style name and adds it as a class attribute value. It is easy to capture this and modify however you wish.