Named parameterGroups are used here to customize the RTF, PostScript and PDF files generated using sub menu of the menu (see
)XXE_install_dir
/addon/config/docbook/xslMenu.incl
Which parameterGroup
s to use for DocBook is described in another document: XMLmind XML Editor - DocBook Support.
The reference manual of Norman Walsh's DocBook XSLT style sheets (which is needed to know, for instance, what means "variablelist.as.blocks
") is found in another document: DocBook XSL Stylesheet Documentation.
<!-- In generated PS, PDF and RTF, format variablelists like the CSS style sheet does. --> <parameterGroup name="docb.toPS.transformParameters"> <parameter name="variablelist.as.blocks">1</parameter> </parameterGroup> <parameterGroup name="docb.toRTF.transformParameters"> <parameterGroup name="docb.toPS.transformParameters"/> </parameterGroup> <!-- Use UTF-8 encoding for generated multi-page HTML. --> <parameterGroup name="docb.toHTML.transformParameters"> <parameter name="chunker.output.encoding">UTF-8</parameter> <parameter name="saxon.character.representation">native;decimal</parameter> </parameterGroup>
It is also possible to extensively customize the Convert commands by specifying alternate XSLT style sheets for them.
Example: defining the following property in any XXE configuration file allows to use customized XSLT style sheet mydocbook.xsl
instead of the one normally used by the docb.toHTML1
process command:
<property name="docb.toHTML1.transform" url="true">mydocbook.xsl</property>
The customized XSLT style sheet always imports the stock style sheet and generally redefines a few custom templates.
<?xml version='1.0' encoding="UTF-8"?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://icl.com/saxon" extension-element-prefixes="saxon"> <xsl:import href="xxe-config:docbook/xsl/html/docbook.xsl"/><xsl:output method="html" encoding="UTF-8"
indent="no" saxon:character-representation="native;decimal"/> </xsl:stylesheet>
In the above example (mydocbook.xsl
found in
), the goal is to generate single-page HTML files using the UTF-8 encoding instead of ISO-8859-1.XXE_install_dir
/doc/configure/samples2/
Another example is found in the documentation of the process
/transform
configuration element. See XMLmind XML Editor - Commands.
In our opinion, it is almost impossible to cope with the complexity of customizing Norman Walsh's DocBook XSLT style sheets without reading this excellent book: DocBook XSL: The Complete Guide - Second Edition by Bob Stayton. See http://www.sagehill.net/book-description.html.