<oXygen/> XML Editor User Guide

The <oXygen/> User Guide

SyncRO Soft Ltd.

Sean Wheller

Legal Notice

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/>
Obtaining and Installing an <oXygen/> License
Upgrading <oXygen/>
Uninstalling <oXygen/>
Memory Management
3. Getting Started
Preferences
Global
Editor
XML Catalog
XML Parser Options
XSLT Options
Debugger Settings
FO processors
XPath
Plugins
External Tools
Menu shortcut keys
File Types
Proxy Configuration
Results / Output
Print
Colors
Main Window
Main Menu
Main Toolbar
Project Panel
Model View Panel
Editor Panel
Message Panel
Outliner Panel
Tree View Window
Main Menu
Main Toolbar
Tree Editing Toolbar
Editor Panel
Message Panel
Information Panel
Entities Panel
All Elements Panel
4. Editing Documents
Creating New Documents
Opening, Saving and Closing Documents
Opening Documents
Opening and Saving Remote Documents via FTP/WebDAV
Saving Documents
Closing Documents
XInclude
Associate schema
Converting Between Grammar Languages
Creating Documents based on Templates
Creating New Templates
Sharing Templates
Editing Documents
Working with Unicode
Streamline with Tag-Insight
Creating DTDs
Working with XML Catalogs
Formatting and Indenting Documents (Pretty Print)
Using XPath Expressions
Using Check Spelling
Using Search and Replace
Using Search and Replace in Files Dialog
Using Go To Dialog
Working with Large Documents
Quick Document Browsing Using Bookmarks
Folding of the XML Elements
Debugging Your Documents
Checking XML Form
Validating Documents
5. Transforming Documents
Transformation Scenarios
Creating a Scenario
The default scenario
Example Transformation Scenarios
PDF Output
PS Output
TXT Output
HTML Output
HTML Help Output
JavaHelp Output
XHTML Output
XSLT processors
Configuring the extension paths for transformer processors.
6. XSLT Debugger
Overview
Layout
Source document view (XML)
Stylesheet document view (XSL)
Output document view
Control view
Working with Debugger
Getting Started
The Debug Process
Output to Source Mapping
Understanding Information Views
7. WSDL Support
Web Services Description Language Overview
Editing WSDL files
Validating WSDL files
Analysing and testing WSDL files
8. XQuery Support
XQuery Overview
Syntax Highlight and Content Completion
XQuery Validation
Transforming XML Documents Using XQuery
9. SVG Editor
The Standalone SVG Viewer.
The Preview Result Pane.
A. Appendix
Accelerator Shortcut Keys
The Main Editor
The Tree View Editor
Unicode Character Encoding
References

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 Save pane
3.5. The Code templates pane
3.6. The Tag Insight Features pane
3.7. The Tag Insight Default pane
3.8. The Tag Insight XSL pane
3.9. The XML Catalog pane
3.10. The XML Parser Options pane
3.11. The JAXP XSLT Transformer option
3.12. Debugger Settings
3.13. The FO processors pane
3.14. Configure the external processors
3.15. The XPath pane
3.16. The Plugins pane
3.17. Configure External Tools
3.18. The Menu shortcut keys pane
3.19. The File Types
3.20. The Proxy Configuration Dialog
3.21. The Results/Output option
3.22. The Printing Scale option
3.23. The Colors pane
3.24. The Main Interface
3.25. The Main Toolbar Buttons
3.26. The Project Toolbar
3.27. The Editor Document Tabs
3.28. The Editor Toolbar Buttons
3.29. The Editor Status Bar
3.30. The Message Panel
3.31. The Outliner Panel
3.32. The Main Interface
3.33. The Main Toolbar Buttons
3.34. The Editor Panel
3.35. The Navigation Panel
3.36. The Editor Status Bar
3.37. The Message Panel
4.1. The Create an XML Document Dialog - XML Schema Tab
4.2. The Create an XML Document Dialog - DTD Tab
4.3. The Create an XML Document Dialog - Relax NG Tab
4.4. The Create an XML Document Dialog - NRL Tab
4.5. Open URL dialog
4.6. The server certificate is not available
4.7. Security alert - untrusted certificate
4.8. Associate schema dialog
4.9. Convert an edited grammar
4.10. The Templates Dialog
4.11. Available Java Encodings Dialog
4.12. Tag-Insight Assistant
4.13. Check Spelling Dialog
4.14. Options Dialog
4.15. Find/Replace Dialog
4.16. Search/Replace in Files
4.17. Go to
4.18. Project panel popup menu
4.19. Project panel new folder dialog
4.20. Project panel toolbar
4.21. Tag-Insight driven by a Docbook DTD
4.22. Tag-Insight configuration dialog
4.23. Tag-Insight list over a document with no DTD
4.24. Editor Bookmarks
4.25. Folding of the XML Elements
4.26. Link to specification for XML Schema errors
5.1. The Configure Transformation Dialog
5.2. Edit cascade stylesheets list dialog
6.1. Debugger Mode Interface
6.2. Control Toolbar
6.3. Output to Source Mapping
6.4. XHTML Output Mapping
6.5. The Context node view
6.6. The XPath watch view
6.7. The Breakpoints view
6.8. The Messages view
6.9. The Stack view
6.10. The Trace History View
6.11. The Templates view
6.12. The Node Set view
6.13. The Variables view
7.1. Tag insight for WSDL
7.2. Validating a WSDL file
7.3. WSDL Analyser
8.1. XQuery Tag Insight
8.2. XQuery Validation
8.3. XQuery Transformation
9.1. SVG Tag Insight
9.2. SVG Viewer
9.3. Integrated SVG Viewer

List of Tables

3.1. File Menu Options
3.2. Edit Menu Options
3.3. Find Menu Options
3.4. Perspective Menu Options
3.5. Options Menu Options
3.6. Plugins Menu Options
3.7. Tools Menu Options
3.8. Debugger Menu Options
3.9. Document Menu Options
3.10. Window Menu Options
3.11. Help Menu Options
3.12. Description of Main Toolbar Buttons
3.13. Description of Project Panel
3.14. Description of Project Toolbar Buttons
3.15. Description of Project View
3.16. Description of Project Menu
3.17. Description of Model View Panel
3.18. Description of the Element Structure View
3.19. Description of the Annotation View
3.20. Description of Editor Toolbar Buttons
3.21. Description of Editor Space Menu
3.22. Message Panel Tab Menu
3.23. The Message Panel Menu
3.24. File Menu Options
3.25. Edit Menu Options
3.26. Insert Menu Options
3.27. Move Menu Options
3.28. Description of Main Toolbar Buttons
3.29. Description of Tree Editing Toolbar Buttons
3.30. Description of Editor Space Menu
3.31. Message Panel Tab Menu
3.32. The Message Panel Menu
3.33. Elements Information
3.34. Attributes Information
3.35. Entities Panel
3.36. All Elements Panel
6.1. Context node details
6.2. XWatch details
6.3. Breakpoints details
6.4. Messages details
6.5. Stack details
6.6. Trace History details
6.7. Templates details
6.8. Node set details
6.9. Variables details
A.1. Unicode to Java Name Matrix

List of Examples

2.1. Example of java command line in startup script (Windows)
4.1. URLs that can be directly opened
4.2. Server URLs
4.3. XPath Utilization with DocBook DTD
4.4. Check XML Form Error Message
4.5. Validate document Error Message