Oxygen XML Author plugin New Document Wizard

The New Document wizard only creates a skeleton document. It contains the document prolog, a root element, and possibly other child elements depending on the options specific for each schema type.

The Oxygen XML Author plugin installs a series of Eclipse wizards for easy creation of documents. If you use these wizards, Oxygen XML Author plugin automatically completes the following details:

The system ID, or schema location of a new XML document.
The minimal markup of a DocBook article, or the namespace declarations of a Relax NG schema.

To create a document, either select File > New > Other > Oxygen XML Author plugin or click the New button on the toolbar.
The New file wizard is displayed.
Select a document type. You can also select New from Templates to create a document based upon predefined templates or custom templates.
Click the Next button.
For example if XML was selected the Create an XML Document wizard is started.
The Create an XML Document dialog box enables definition of an XML Document Prolog using the system identifier of an XML Schema, DTD, Relax NG (full or compact syntax) schema, or NVDL (Namespace-based Validation Dispatching Language) schema. As not all XML documents are required to have a Prolog, you can choose to skip this step by clicking OK. If the prolog is required, complete the fields as described in the next step.
Type a name for the new document and press the Next button.
If you select Customize, Oxygen XML Author plugin opens the following dialog box. You can customize various options, depending on the document type you select.
Figure: New XML Document Dialog Box
- URL - Specifies the path to the schema file. When you select a file, Oxygen XML Author plugin analyzes its content and tries to fill the rest of the dialog box.
- Schema type - Allows you to select the schema type. The following options are available: XML Schema, DTD, RelaxNG XML syntax, RelaxNG compact syntax, and NVDL.
- Public ID - Specifies the PUBLIC identifier declared in the document prolog.
- Namespace - Specifies the document namespace.
- Prefix - Specifies the prefix for the namespace of the document root.
- Root Element - Populated with elements defined in the specified schema, enables selection of the element used as document root.
- Description - A small description of the selected document root.
- Add optional content - If you select this option, the elements, and attributes defined in the XML Schema as optional, are generated in the skeleton XML document.
- Add first Choice particle - If you select this option, Oxygen XML Author plugin generates the first element of an xs:choice schema element in the skeleton XML document. Oxygen XML Author plugin creates this document in a new editor panel when you click Finish.
Figure: New XSL Document Dialog Box
- Stylesheet version - Allows you to select the Stylesheet version number. You can select from: 1.0, 2.0, and 3.0.
- Add documentation annotations - Adds annotation for XSL components.
- Open file for editing when done - Specifies whether or not you want to open the newly created file in the editor.
Figure: New XML Schema Document (XSD) Dialog Box
- Default XML Schema version - Uses the XML Schema version defined in the XML Schema preferences page.
- XML Schema 1.0 - Sets the minVersion attribute to 1.0 and the maxVersion attribute to 1.1.
- XML Schema 1.1 - Sets the minVersion attribute to 1.1.
- Target namespace - Specifies the schema target namespace.
- Namespace prefix declaration table - Contains namespace prefix declarations. To manage table information, use the New and Delete buttons.
Figure: New Schematron Document Dialog Box
- Schematron version - Specifies the Schematron version. Possible options: 1.5 and ISO.
- Open file for editing when done - Specifies whether or not you want to open the file for editing purposes.