The following examples use the DocBook XSL Stylesheets to illustrate how to configure oXygen for transformation to the various target formats.
The following steps are common to all the example procedures below.
Set the editor focus to the document to be transformed.
Select Ctrl+Shift+C) to open the Configure Transformation dialog.
-> (Select the XSLT tab.
Click the “Browse for an input XSL file button”. The Open dialog is displayed.
During transformations the Editor Status Bar will show “Transformation - in progress”. The transformation is successfully complete when the message “XSL transformation successful” displays. If the transform fails the message “XSL transformation failed” is displayed as is an error message in the Message Panel.
Change directory to ../docbook-xsl/fo/.
Select docbook.xsl, click
. The dialog closes.Select the FOP tab.
Check the
option. The remaining options are enabled.Select the following options:
XSLT result as input.
PDF as method.
Built-in(Apache FOP) as processor.
Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.pdf)
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to ../docbook-xsl/fo/.
Select docbook.xsl, click
. The dialog closes.Select the FOP tab.
Check the
option. The remaining options are enabled.Select the following options:
XSLT result as input.
PS as method.
Built-in(Apache FOP) as processor.
Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.ps)
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to ../docbook-xsl/fo/.
Select docbook.xsl, click
. The dialog closes.Select the FOP tab.
Check the
option. The remaining options are enabled.Select the following options:
XSLT result as input.
TXT as method.
Built-in(Apache FOP) as processor.
Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.txt)
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to ../docbook-xsl/html/.
Select docbook.xsl, click
. The dialog closes.Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.html)
If your pictures are not located relative to the out location, check the XHTML check box in the Show As group.
Specify the path to the folder or URL where the pictures are located
Click
. The transformation is started.Change directory to ../docbook-xsl/htmlhelp/.
Select htmlhelp.xsl, click
. The dialog closes.Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.chm)
If your pictures are not located relative to the out location, check the XHTML check box in the Show As group.
Specify the path to the folder or URL where the pictures are located
Click
. The transformation is started.Change directory to ../docbook-xsl/javahelp/.
Select javahelp.xsl, click
. The dialog closes.Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.html)
If your pictures are not located relative to the out location, check the XHTML check box in the Show As group.
Specify the path to the folder or URL where the pictures are located
Click
. The transformation is started.Change directory to ../docbook-xsl/xhtml/.
Select docbook.xsl, click
. The dialog closes.Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Select the Output tab.
In the “Save As” field enter the path and output file name (YourFileName.html)
If your pictures are not located relative to the out location, check the XHTML check box in the Show As group.
Specify the path to the folder or URL where the pictures are located
Click
. The transformation is started.