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.
The following steps are common to all the example procedures below.
Set the editor focus to the document to be transformed.
Select Alt+Shift+T C (Cmd+Alt+T C on Mac OS)) 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, if the transformer offers such support, by pressing the "Stop transformation" button. In this case the message displayed in the status bar will be "Transformation stopped by user". For the specific case of an XQuery transformation, if you chose an NXD transformer, pressing the "Stop transformation" button will have no effect, as NXD transformers offer no such support.
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.