Table of Contents
This section provides an overview of the <oXygen/> plugin Graphic User Interface (GUI). It provides you with an explanation of the interface components and a short description of its purpose or usage.
The <oXygen/> plugin GUI is integrated in the Eclipse platform by the following components:
Once <oXygen/> is installed you may want to use the following preferences to customize <oXygen/> for your requirements and network environment.
If selected the <oXygen/> plugin will perform a well-formed check every time the user saves a document that <oXygen/> created or opened.
The path to a web browser executable to be used to open XSLT or PDF transformation results.
In this pane the user can configure visual aspect and formatting parameters and content assistant behavior.
This option enables the selection of the font family and size used to display text.
The user can set the background color of the editor.
This option will automatically wrap lines in edited documents.
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.
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.
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 the Format and Indent operation will output empty elements with a separate closing tag, ex. <a atr1="v1"></a>. When not checked the same operation will represent an empty element in a more compact form: <a atr1="v1"/>
When checked the Format and Indent operation will sort the attributes of an element alphabetically. When not checked the same operation will leave them in the same order as before applying the operation.
This list contains the names of the elements for which the contained white spaces like blanks, tabs and newlines are preserved by the Format and Indent operation exactly as before applying the operation.
This list contains the names of the elements for which contiguous white spaces like blanks, tabs and newlines are merged by the Format and Indent operation into one blank.
The Tag-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.
These settings define the operating mode of the content assistant.
This option enables Tag-Insight feature. When unchecked, all Tag-Insight features are disabled.
When inserting elements from the Tag-Insight assistant, both start and end tags are inserted.
When checked, <oXygen/> will insert automatically the required elements from the DTD or XML Schema.
When checked, <oXygen/> will insert automatically the required attributes from the DTD or XML Schema for an element inserted with the help of the Tag-Insight assistant.
When checked, <oXygen/> will insert automatically any FIXED attributes from the DTD for an element inserted with the help of the Tag-Insight assistant.
When checked, <oXygen/> will display a list with all the internal and external entities declared in the current document when the user types the start character of an entity reference (i.e. &).
The URL of the default DTD / XML Schema to be used when no grammar is specified in the edited document.
The URL of the default DTD / XML Schema to be used when no grammar is specified in the edited document.
Used to specify the full path location of the DTD file that will be used to initialize the Tag-Insight assistant when a document does not define a DTD, XML Schema, Relax NG or NRL schema.
Used to specify the full path location of the XML Schema file that will be used to initialize the Tag-Insight assistant when a document does not define a DTD, XML Schema, Relax NG or NRL schema.
These settings define what elements are suggested by the content assistant in addition to the XSL ones.
The Tag-Insight will offer only the XSL information.
Includes XHTML Transitional elements as substitute for xsl:element.
Includes Formating Objects elements as substitute for xsl:element.
Includes elements from a DTD file or a XML Schema file specified from a URL as substitute for xsl:element.
An XML catalog is a set of mappings between remote DTD and/or XML Schema and/or Relax NG files and local copies of these files. When Internet access is not available or is slow one or more XML catalogs can be added to the list in the dialog below and the local copies of the DTD and/or XML Schema and/or Relax NG files will be used during validation. When you add or delete an XML catalog to the list of XML catalogs in the Options -> Preferences -> XML Catalog pane you must restart the application so that the changes take effect.
The Prefer option is used to specify whether <oXygen/> will try to resolve first the PUBLIC or SYSTEM reference using the specified XML catalogs. If a PUBLIC reference is not mapped in any of the catalogs then a SYSTEM reference is looked up.
The verbosity level specifies the types of output messages displayed to standard output and can have one of the values: debug, warn, info, error and fatal.
If the user has added no XML catalogs to this list then <oXygen/> will add by default the built-in catalogs for DocBook and TEI documents located in the docbook and tei subdirectories of the installation directory.
Besides the built-in formatting objects processor (Apache FOP) the user can use other external processors. <oXygen/> has implemented an easy way to add XEP as external FO processor if the user has the XEP installed.
When checked all FOP output will be displayed in a results pane at the bottom of the editor window including annoying messages about FO instructions not supported by FOP.
If your FOP transformations fail with an “Out of Memory” error select from this combo box a larger value for the amount of memory reserved for FOP transformations.
You should specify here the path to a FOP configuration file, necessary for example to render to PDF using a special true type font a document containing Unicode content.
The users can configure the external processors for use with <oXygen/> in the following dialog.
The name that will be displayed in the list of available FOP processors on the FOP tab of the Transforming Configuration dialog.
The description of the FO processor displayed in the Preferences->FO Processors option.
The directory in which the intermediate and final results of the processing will be stored.
The command line that will start the FO processor, specific to each processor.
http://apache.org/xml/features/validation/schema - This option sets the 'schema' feature to true.
http://apache.org/xml/features/validation/schema-full-checking - This option sets the 'schema-full-checking' feature to true.
Validate against a XML Schema even if a DTD is specified - This option forces validation against a referred XML Schema even if the document includes a DTD declaration.
If you want to use an XSLT transformer different than the ones that ship with <oXygen/> namely Apache Xalan and Saxon all you have to do is to specify the name of the transformer's factory class which <oXygen/> will set as the value of the Java property "javax.xml.transform.TransformerFactory". To perform an XSLT transformation with Saxon 7 for instance you have to place the Saxon 7 jar file in the <oXygen/> libraries directory (the lib subdirectory of the installation directory), set "net.sf.saxon.TransformerFactoryImpl" as the property value and select JAXP as the XSLT processor in the transformation scenario associated to the transformed XML document.
Allows the user to enter the name of the transformer factory Java class.
Some networks use Proxy servers to provide Internet Services to LAN Clients. Clients behind the Proxy may therefore, only connect to the Internet via the Proxy Service. The Proxy Configuration dialog enables this configuration. If you are not sure whether your computer is required to use a Proxy server to connect to the Internet or the values required by the Proxy Configuration dialog, please consult your Network Administrator.
Open the Proxy Configuration dialog by selecting
-> -> .Complete the dialog as follows:
When checked enables <oXygen/> to use the specified Proxy Server. When unchecked, Proxy Server is disabled.
The IP address or Fully Qualified Domain Name (FQDN) of the Proxy Server.
The TCP Port Number, normally set to 80 or 8080.
The Name of the user if required. Can be empty.
The Password for authentication. Can be empty.
Specify domains for which no proxy should be used.
When checked enables SOCKS using the specified host and port for the server. When unchecked, SOCKS is disabled.
The SOCKS host you wish to connect to.
The SOCKS port you wish to connect to.
<oXygen/> support Syntax Highlight for XML, DTD, Relax NG (XML and Compact Syntax), Java, C++, C, PHP, Perl, Properties, SQL, Shell and Batch documents. 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 Options->Preferences->Colors and choose one of the supported Document Types. Each document type contains a set of Tokens. When the Document Type is selected the associated tokens are listed. Selecting a token displays the current color properties and enables you to modify them.