The oXygen User Guide

SyncRO Soft Ltd.

Sean Wheller

Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and SyncRO Soft Ltd., was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this book, the publisher assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

Third party software components are distributed in the <oXygen/> installation packages, including the Java Runtime Environment (JRE), DocBook DTD and style sheets. This product includes software developed by the Apache Software Foundation (http://www.apache.org): the Apache FOP, Xerces XML Parser and Xalan XSLT. These products are not the property of SyncRO Soft Ltd.. To the best knowledge of SyncRO Soft Ltd. owners of the aforesaid products granted permission to copy, distribute and/or modify the software and its documents under the terms of the Apache Software License, Version 1.1. Other packages are used under the GNU Lesser General Public License. Users are advised that the JRE is provided as a free software, but in accordance with the licensing requirements of Sun Microsystems. Users are advised that SyncRO Soft Ltd. assumes no responsibility for errors or omissions, or for damages resulting from the use of <oXygen/> and the aforesaid third party software. Nor does SyncRO Soft Ltd. assume any responsibility for licensing of the aforesaid software, should the relevant vendors change their terms. By using <oXygen/> the user accepts responsibility to maintain any licenses required by SyncRO Soft Ltd. or third party vendors. Unless SyncRO Soft Ltd. declares in writing that the <oXygen/> license is inclusive of third party licensing.

Revision History
Revision 3.09 January 2004
Revision 2.0.311 August 2003
Beta
Revision 2.0.24 June 2003
Beta
Revision 2.028 March 2003
Release

Table of Contents

1. Introduction
Key Features
About the oXygen Handbook
2. Installation
Installation Requirements
Platform Requirements
Operating System, Tools and Environment Requirements
Installation Instructions
Starting oXygen plugin
Obtaining and Installing an oXygen License
Upgrading oXygen
Uninstalling the oXygen plugin
3. Getting Started
Preferences
Global
Editor
XML Catalog
FO processors
XML Parser Options
JAXP XSLT Transformer
Proxy Configuration
Colors
The oXygen custom menu
XML Menu
The oXygen toolbar buttons
The Editor Pane
Outliner Panel
XML Document Overview
Modification Follow-up
Document Tag Selection
The oXygen Text View
The oXygen XPath View
4. Transforming Documents
Transformation Scenarios
Creating a Scenario
Example Transformation Configurations
PDF Output
PS Output
TXT Output
HTML Output
HTML Help Output
JavaHelp Output
XHTML Output

List of Figures

2.1. Registration Dialog
3.1. The Global preferences
3.2. The Aspect pane
3.3. The Format pane
3.4. The Tag Insight Features pane
3.5. The Tag Insight Default pane
3.6. The Tag Insight XSL pane
3.7. The JAXP XSLT Transformer option
3.8. The Proxy Configuration Dialog
3.9. The <oXygen/> Toolbar Buttons
3.10. The Editor Pane
3.11. The Outliner Panel
3.12. The <oXygen/> Text View
3.13. The <oXygen/> XPath View
4.1. The Configure Transformation Dialog

List of Tables

3.1. XML Menu Options
3.2. Description of <oXygen/> Toolbar Buttons
3.3. Description of <oXygen/> Editor Types
3.4. Description of Outline Toolbar Buttons