Table of Contents
This chapter explains how to create, edit and manage files as part of a project within the oXygen XML Editor.
oXygen enables a high-level of customization to the way in which text is displayed, managed and edited.
The oXygen Editor is not a WYSIWYG or quasi-WYSIWYG editor. The reason for this is that the principle of single-source, or structured mark-up, detaches content and presentation layers. This enables a greater degree of flexibility and interchange between applications by enabling the preparation of multiple target ready content. Each format defines its own presentation layer using one or more viewer technologies suitable for delivery across a variety of applications, such as Web Browsers, Cellular Phones, Interactive Voice Response and Speech Recognition systems.
When using oXygen it is therefore helpful to keep in mind that format and layout are controlled by a style sheet that applies the final formatting and layout during the transformation phase. Formating under the editor is therefore only for the purpose of optimizing the editor space and increasing convenience while editing.
Syntax Highlighting promotes easier readability by applying colors to the mark-up tags. Syntax Highlighting not only enables you to distinguish mark-up from content, but also highlights differences between tag types and their attributes. The oXygen XML Editor supports syntax highlight for XML, DTD, Java, C, C++, SQL, PHP, Perl, Properties, Shell and Batch.
While oXygen provides a default color configuration for highlighting the tokens, you may choose to customize, as required, using the Colors dialog.
Open the Colors dialog by selecting
-> ->Colors option. .Color profiles for Syntax Highlighting are stored according to Document Types. When selecting a document type will appear a list of tokens with the default colors values. Selecting a token displays a dialog were the color properties can be changed. Use Swatch, HSB or RGB models to define the color properties.
Complete the dialog as follows:
Displays a color pallet containing a variety of colors from across the color spectrum and shades thereof. Select a color.
Hue, Saturation and Brightness (HSB) enables you to specify a color by describing it using hue, saturation and brightness.
Red, Green and Blue (RGB) enables you to specify a color using triplets of red, green and blue numbers.
Displays the color properties of the current token and results of customization.
Modifications are saved when the
or button is clicked. discards changes.oXygen enables custom selection of the font-type and size used in the Editing Space by means of the Editor Font dialog.
Open the Editor Font dialog by selecting
-> ->Editor->Font option.Complete the dialog as follows:
Displays the list of fonts installed on the system environment. Click the drop-list to view and select a font type.
Increments or decrements font size in points.
Displays a preview of the selected font and size.
Modifications are saved when the
button is clicked. discards changes.Text layout, formatting preferences and behavior can be customized using the Editor option from the Preferences dialog.
Select the Editors option in
-> .Complete the dialog as follows:
Enabling this option will wrap lines automatically in the edited documents so that all the characters on a line fit in the displayed window.
Marks the EOL and EOF characters with a graphical symbol for a easier visualization.
Displays the line numbers on the left part of the editing space.
Sets the number of spaces or the tab size that will equal a single indent. The Indent can be spaces or a tab, select the preference using the Indent With Tabs option. If set to 4 one tab will equal 4 white spaces or 1 tab with size of 4 characters depending on which option was set in the Indent With Tabs option.
Defines the point at which the “Format and Indent” (Pretty-Print) function will perform line wrapping. So if set to 100 Pretty-Print will wrap lines at the 100th space inclusive of white spaces, tags and elements.
When checked enables 'Indent with tabs' to sets the indent to a tab unit. When unchecked, 'Indent with tabs' is disabled and the indent will measure as many spaces as defined by the 'Indent size' option.
Smart Indent attempts to indent mark-up in accordance to the tag/text and its position/context within the body of a document. This option either enables or disables the use of smart indenting.
Enables automatic save of the edited document at time intervals set by the next option.
Sets the time interval between automatic saves.
Modifications are saved when the
button is clicked. discards changes.It is sometimes useful to print out the contents of a document on paper. oXygen allows you to adjust the scale of the print output to make it easier to read on a page.
Open the Print Scale dialog by selecting
-> -> Print.The Code-Insight feature enables in line syntax lookup and Auto Completion of mark-up elements and attributes to streamline mark-up and reduce errors while editing.
The Code-Insight feature is populated by the elements and attributes supplied by a specified DTD or XML Schema defined by the System Identifier in the Document Type Declaration. The absence of a System Identifier would therefore depreciate the functionality of the Code-Insight feature, resulting in the display of an incomplete or non accurate element and attributes list. As not all XML documents are required to have a System Identifier, oXygen provides a method to specify a DTD or XML Schema within the application. When Code-Insight detects that the a document does not have a System Identifier declared, it will default to using the DTD or XML Schema specified within the Code-Insight Configuration dialog. Before starting work it is recommended that you configure Code-Insight with your personal preferences using the options provided.
Specification of DTD or XML Schema and behavioral settings of the Code-Insight assistant are configured via the Code-Insight option from the Preferences dialog.
Complete the dialog as follows:
Enables/disables all the Code-Insight options.
When inserting elements from the Code-Insight assistant, both start and end tags are inserted.
When inserting a new element oXygen will add automatically the required elements inside the new element, specified in DTD or XML Schema file.
Having manually typed the start tag of an element, oXygen will automatically insert the ending tag when </ is typed.
When inserting an element from the Code-Insight assistant, the cursor is automatically positioned before the > bracket of the start tag. Entering a space displays the attributes supported by the inserted element.
Complete the dialog as follows:
Used to specify the full path location of the DTD file that will be used to initialize the Code-Insight assistant when a document does not define a DTD or XML Schema.
Used to specify the full path location of the XML Schema file that will be used to initialize the Code-Insight assistant when a document does not define a DTD or XML Schema.
Complete the dialog as follows:
includes none of the elements declared in the schema
includes XHTML Transitional elements declared in the schema
includes Formating Objects elements declared in the schema
includes elements from a DTD file or a XML Schema file specified from a URL
Modifications are saved when the
button is clicked. discards changes.