The following examples use the DocBook XSL Stylesheets to illustrate how to configure <oXygen/> for transformation to the various target formats.
<oXygen/> comes with the latest versions of the DocBook and TEI
frameworks including special XSLT stylesheets for DocBook and TEI documents.
DocBook XSL extensions for the Saxon and Xalan processors are included in the
frameworks/docbook/xsl/extensions
directory. Also the FXSL (Functional
Programming Library for XSLT) stylesheets are shipped with
<oXygen/>.
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.
-> (If you want to edit an existing scenario select that scenario in the list and press the Edit button. If you want to create a new scenario press the New button. If you want to create a new scenario based on an existing scenario select the scenario in the list and press the Duplicate button.
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 an error message in the Messages Panel. The user can stop the transformation process at any point by pressing the "Stop transformation" button. In this case the message displayed in the status bar will be "Transformation stopped by user".
Change directory to [oxygen]/frameworks/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 output file name
relative to the current directory (YourFileName.pdf
) or the path and output file name
(C:\FileDirectory\YourFileName.pdf
).
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to [oxygen]/frameworks/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 output file name
relative to the current directory (YourFileName.ps
) or the path and output file name
(C:\FileDirectory\YourFileName.ps
).
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to [oxygen]/frameworks/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 output file name
relative to the current directory (YourFileName.txt
) or the path and output file name
(C:\FileDirectory\YourFileName.txt
).
Optionally, uncheck the XHTML and XML check boxes in the Show As group.
Click
. The transformation is started.Change directory to [oxygen]/frameworks/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 output file name
relative to the current directory (YourFileName.html
) or the path and output file name
(C:\FileDirectory\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 [oxygen]/frameworks/docbook/xsl/htmlhelp/.
Select htmlhelp.xsl
, click
. The dialog closes.
Set the XSLT parameter base.dir, it identifies the output directory. (If not specified, the output directory is system dependent.) Also set the manifest.in.base.dir to 1 in order to have the project files copied in output as well.
Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Click
. The transformation is started.At the end of the transformation you should find the html, hhp and hhc files in the base.dir directory.
Download Microsoft's HTML Help Workshop and install it.
Apply the HTML Help compiler called hhc.exe
on
the html, hhp and hhc files in the base.dir directory.
Change directory to [oxygen]/frameworks/docbook/xsl/javahelp/.
Select javahelp.xsl
, click
. The dialog closes.
Set the XSLT parameter base.dir, it identifies the output directory. (If not specified, the output directory is system dependent.)
Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Click
. The transformation is started.Change directory to [oxygen]/frameworks/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 output file name
relative to the current directory (YourFileName.html
) or the path and output file name
(C:\FileDirectory\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.