9. Parametrizing the XSLT style sheets used in the Convert Document submenu
Prev | Chapter 5. Customizing an existing configuration | Next

## 9. Parametrizing the XSLT style sheets used in the Convert Document submenu

Add one or more parameterGroup configuration elements to your custom `.xxe` file:

    <parameterGroup name="Name of the parameter group">
      <parameter name="Name of parameter #1">Value or parameter #1</parameter>
      <parameter name="Name of parameter #2">Value or parameter #2</parameter>
      <parameter name="Name of parameter #3">Value or parameter #3</parameter>
    </parameterGroup>

Which parameters to specify is found by reading the documentation of the XSLT style sheets. For example, the reference manual of the DocBook XSLT style sheets is: DocBook XSL Stylesheet Documentation.

Configuration Name | Convert to | Name of the `parameterGroup`
--- | --- | ---
DocBook v5+ | HTML multi-page | `db5.toHTML.transformParameters`
HTML single page | `db5.toHTML1.transformParameters`
HTML Help | `db5.toHTMLHelp.transformParameters`
Java Help | `db5.toJavaHelp.transformParameters`
Eclipse Help | `db5.toEclipseHelp.transformParameters`
RTF, WordprocessingML, OpenDocument, OOXML | `db5.toRTF.transformParameters`
PDF, PostScript | `db5.toPS.transformParameters`
DocBook | HTML multi-page | `docb.toHTML.transformParameters`
HTML single page | `docb.toHTML1.transformParameters`
HTML Help | `docb.toHTMLHelp.transformParameters`
Java Help | `docb.toJavaHelp.transformParameters`
Eclipse Help | `docb.toEclipseHelp.transformParameters`
RTF, WordprocessingML, OpenDocument, OOXML | `docb.toRTF.transformParameters`
PDF, PostScript | `docb.toPS.transformParameters`
XHTML Strict XHTML Transitional | RTF, WordprocessingML, OpenDocument, OOXML | `xhtml.toRTF.transformParameters`
PDF, PostScript | `xhtml.toPS.transformParameters`

Example: Use UTF-8 encoding when convert DocBook documents to 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>

Example: When converting DocBook v5+ document to RTF, WordprocessingML, OpenDocument, OOXML or to PDF, PostScript, style `variablelist` like XXE does it on screen. That is, do not put the term and its definition side by side.

    <parameterGroup name="db5.toRTF.transformParameters">
      <parameter name="variablelist.as.blocks">1</parameter>
    </parameterGroup>

    <parameterGroup name="db5.toPS.transformParameters">
      <parameter name="variablelist.as.blocks">1</parameter>
    </parameterGroup>

Prev | Up | Next
8. Adding items to the menu | Home | 10. Customizing the XSLT style sheets used in the Convert Document submenu