<oXygen/> XML Editor User Guide |
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.
SelectCtrl+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.
![]() | Note |
---|---|
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 relativ 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 relativ 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 relativ 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.)
Select the FOP tab.
Uncheck the
option. The FOP options are disabled.Click
. The transformation is started.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 relativ 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.