Table of Contents
This section provides an overview of the oXygen Graphic User Interface (GUI). It provides you with an explanation for each of the interface components and a short description of its purpose or usage. The oXygen interface is splitted in two separate windows, but linked:
The oXygen interface uses standard interface conventions and components to provide a familiar and intuitive editing environment across all operating systems.
The main window is central to the work process. In addition to the title bar, which shows the oXygen program icon, name, license information, the main window is comprised of the following main components:
When two or more main window panels are displayed, oXygen provides divider bars that allow arrangement of screen real-estate. By selecting a divider bar it can be dragged to a new position, so increasing the space occupied for one panel, while decreasing it for the other. Using this method you can optimize the desktop to your workspace requirements.
As majority of the work process centers around the Editor panel, other panels can be hidden from view using the expand and collapse controls located on the divider bars.
The main menu, located below the program title bar, provides menu driven access to all the features and functions available within oXygen.
Macintosh users should use the command key instead of the control key for all keyboard shortcuts.
Table 3.1.
Menu Options![]() |
|
Table 3.2.
Menu Options![]() |
|
Table 3.3.
Menu Options![]() |
|
Table 3.5.
Menu Options![]() |
Table 3.9. XML Menu Options
![]() |
|
Table 3.10.
Menu Options![]() |
|
The Main toolbar, located below the Main menu, provides easy access to common and frequently used functions. Each icon is a button that acts as a short-cut to a related function. Hold the pointer-cursor over an icon to display a context label that will give you a hint as to its function. Click an icon to use its' function.
Table 3.11. Description of Main Toolbar Buttons
![]() | Ctrl+N): Displays the New dialog from which to select the document file type. -> ( |
![]() | Ctrl+O): Displays the Open dialog used to discover, select and open one or more files. -> ( |
![]() | Ctrl+S): Saves the current document. If the document does not have a file, displays the “Save As” dialog. -> ( |
![]() | Save As: Displays the Save As dialog, used to name and save an open document to a file; or save an exiting file with a new name. |
![]() | Save All: Saves all open documents. If any document does not have a file, displays the “Save As” dialog. |
![]() | : Displays the Templates dialog used to discover, select and open a new document based on an exiting template document. Template documents act as starting points that have predefined properties such as file type, prolog, root element, containers and even exiting content. |
![]() | New from templates” option. : Displays the Add Templates dialog used to define the name by which the template will be recognized in the “ |
![]() | Ctrl+Z): Reverses, a maximum of 100, editing actions to return to the preceding state. -> ( |
![]() | Ctrl+Shift+Z): Recreates, a maximum of 100, editing actions that were undone by the “Undo” function. -> ( |
![]() | Ctrl+X): Removes the current selection from the document and places it in the clipboard. -> ( |
![]() | Ctrl+C): Places a duplicate copy of the current selection in the clipboard. -> ( |
![]() | Ctrl+V): Places the current clipboard content into the document at the cursor position. -> ( |
![]() | F4): Checks the spelling of the current document. -> ( |
![]() | Ctrl+F): Displays the Find/Replace dialog, used define “search for” or “search for and replace” operations on the current document. -> ( |
![]() | search for” or “search for and replace” operations across a number of files. : Displays the Search/Replace in Files dialog, used to define “ |
![]() | Ctrl+T): Displays the Tree View window. -> ( |
: Displays the available External Tools. |
The Project panel, located on the left-hand side of the Main window, enables the definition of projects and logical management of the documents it contains.
The Project toolbar, located on the top of the Project panel, provides easy access to oXygen project functions. Each icon is a button that acts as a short-cut to a related function. Hold your the pointer-cursor over an icon to display a context label that will give you a hint as to its function. Click an icon to use its' function.
Table 3.13. Description of Project Toolbar Buttons
![]() | : Create a new project in the Project pane. |
![]() | Ctrl+F2): Displays the Open Project dialog used to discover, select and open a project file. -> ( |
![]() | Ctrl+F3): Saves the current project. If the project does not have a file, displays the “Save Project As” dialog. -> ( |
![]() | : Toggles the file path ON and OFF for all files displayed in the Project View. |
![]() | : Displays the New Folder dialog, used to specify the name of a folder about to be created under the existing and selected Project or Folder in the Project View. |
![]() | : Removes the selected folder its contents from the Project View. |
![]() | : Includes the current document into the selected folder in the Project View. |
The Project view provides a method for logical management and visualization of files associated with a project. Once a project is open, saved files can be added to, or removed from, the project. Either while open in the Editor Panel or directly from a local or remote file system.
Table 3.14. Description of Project View
![]() | To help organize files, virtual folders can be created. Virtual folders only exist within the project file, providing a logical method for visual organization. In addition to internal creation of Virtual Folders, you can also import system folders and their contents from local or remote file systems. The result is a tree-view that promotes navigation and easy file management within the project, regardless of the files physical location. All folders, whether created internally or imported, have no physical connection with a local or remote file system. i.e. If you add, delete or rename a Project folder those operations are only performed in the oXygen project file. The same principle is applicable to files, with the exception that the representation of a file in the Project View does maintain a backward link to the physical file. i.e. Actions such as “Remove”, only removes the file from the current project file, it does not delete the file from the file system. Double-clicking a file is equivalent to -> (Ctrl+O) . The full path to file is hidden by default. Click the Show/Hide Path button to toggle the file path on or off. The default target when adding files to a project is the project root. Selecting a folder changes the target to the selected folder. Files may have multiple instances, within the folder system but cannot appear twice within the same folder. Right-clicking any object in the tree-view displays the Project menu with functions that can be performed on, or from the selected object. Options available from the Project menu are specific to the object type selected in the tree-view. |
Table 3.15. Description of Project Menu
From the Project Object ![]() From the Folder Object ![]() From the File Object ![]() |
The Editor panel is were you spend most your time, reading, editing, applying markup and checking the validity and form of your documents.
The Editor panel is comprised of:
The oXygen editor uses the tabbed page mode to display open documents. The document tab is located above the Editor Toolbar and shows the file type, file name and its edit status.
Modified files are denoted with an “*”, saving the document removes this status until the next edit operation.
Each open document has an associated tab displaying this information. To distinguish which document is currently under edit, the active document is highlighted and brought to the foreground. Inactive document tabs are shadowed in the background. Selecting a tab changes the document focus to display its contents for editing. Hovering the pointer over a tab displays the files full path in a tool tip.
Right-click on any tab to display the Document Tab menu.
Document Tab Menu
: Closes only the selected tab. All other tab instances remain.
: Closes all open documents. If a document is modified or has no file, a prompt to save, not to save, or cancel the save operation is displayed.
The file type is denoted by an icon preceding the filename. While this information can be obtained from the file extension, visual identification of style types is improved using a color legend that correlates to the Project View icons:
XML Documents
DTD Documents
XSD Documents
XSL Documents
TXT Documents
The Editor toolbar, located below the Document Tabs, provides easy access to oXygen editing functions. Each icon is a button that acts as a shortcut to a related function. Hold your the pointer-cursor over an icon to display a context label that will give you a hint as to its function. Click an icon to use its function.
Table 3.16. Description of Editor Toolbar Buttons
![]() | Ctrl+Shift+V): Executes the Validation operation on the current document using a validating parser. Returns an error result-list in the Message panel. Mark-up of current document is checked to conform with the specified DTD or XML Schema rules. -> ( |
![]() | Ctrl+Shift+W): Executes the XML Form check operation on the current document using a non-validating parser. Returns an error result-list in the Message panel. -> ( |
![]() | -> : Displays the RELAX NG Validation dialog, used to select the Relax NG schema and to execute the Validation operation on the current document using the selected Relax NG Schema. Returns an error result-list in the Message panel. Mark-up of current document is checked to conform with the specified RNG Schema rules. |
![]() | Ctrl+Shift+T): Executes the transformation process using the configuration properties defined in the Configure Transformation dialog. -> ( |
![]() | Ctrl+Shift+C): Displays the Configure Transformation dialog, used to define properties for conversion of documents to multiple output targets. Also enables saving of “Scenario's”. Each scenario, can store a unique configuration ready to be used in the future. -> ( |
![]() | Ctrl+Shift+P): Also referred to as “Pretty Print”, “Format and Indent” performs layout functions to make mark-up easier to read on screen and in print output. -> ( |
![]() | Ctrl+Shift+L): Reads the mark-up structure of the current document so that it can be saved as a template using the option. -> ( |
![]() | Ctrl+Shift+S): Displays the Save Structure dialog, used to name and create DTD documents learnt by the “Learn Structure” function. -> ( |
![]() | Lock” mode tags cannot be edited. Unlock to enable tag editing. : When in “ |
: Executes an XPath expression, used to select specified elements within the current document.
The oXygen editor provides a useful set of features that promote easy editing of structure mark-up documents. Features such as automatic syntax highlighting and checking, intelligent Code-Insight, end tag auto completion help improve productivity and reduce errors. Text attributes such as font, formatting, coupled with customizable coloring options for syntax highlighting provide a flexible and powerful structured mark-up editor.
Right-click anywhere in the editor to display a menu with options related to editing and mark-up operations.
Table 3.17. Description of Editor Space Menu
![]() |
|
The Editor status bar, located below the Editing space, provides information about the current document:
Displays the full path of the current document.
Displays the status of Validate XML, Check XML Form, Apply Transformation, XPath expression evaluation and Format and Indent (Pretty Print) operations and the result (success or not) and number of errors found in the last operation.
Displays the current position of the cursor in terms of Line Number: Space Number.
Indicates whether or not the document has been modified since the last save.
The Message panel, located across the bottom half of the Main Window, displays messages returned from the following operations:
To distinguish between result types, each functions result-list is displayed in a separate tab within the panel.
To change focus between the result-lists, just select the tab required. To close a tab, or all tabs, right-click the tab to display a menu and select an option.
Table 3.18. Message Panel Tab Menu
![]() |
In all instances, each record within a result-list is linked to the document location where the indicated error or character string will be found. Selecting a result list record moves the Editors cursor to, and highlights the object in question. If the target document is closed, it will be opened in the Editor panel.
In addition to this time saving feature, the Message panel menu enables several operations to be performed on single or multiple selected records. The Message panel menu is displayed by selecting a record, then right-clicking.
Table 3.19. The Message Panel Menu
![]() |
|
The “Validate XML ” and “Check XML Form” functions use the same tab instance named “errors” to display their results. As both functions use the same tab instance, “Validate XML ” and “Check XML Form” result-lists overwrite one another. Each time one of these functions is executed the result-list is populated with new results.
When working with XPath expressions, oXygen outputs errors and node results to the message panel.
During transformation processes, XML, XHTML or FOP, the message panel is used to display, parser errors, warning messages and output of XML or XHTML. Each is displayed in a separate tab. Tab instances for XML/XHTML are created on a per document basis, error and warning tabs are simply repopulated.
The “Find/Replace” function opens a new tab instance for each document on which the function is run. Each tab instance is named “Find all results - <filename.ext>”. Each time that the function is run the result-list in the documents associated tab instance is populated with new results.