Oxygen Plugin Wizard for New Document

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

The Oxygen plugin installs a series of Eclipse wizards for easy creation of new documents. Using these wizards you let Oxygen complete details like 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.

  1. Select File > New > -> Other (Ctrl+N) > oXygen or press the New toolbar button. The New wizard is displayed.
  2. Select a document type.
  3. Click the Next button.

    For example if XML was selected the Create an XML Document wizard is started.

    The Create an XML Document dialog 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 may choose to skip this step by clicking OK. If the prolog is required, complete the fields as described in the next step.

  4. Type a name for the new document and press the Next button.
  5. If Customize was clicked, the following dialog is opened. Depending on the selected document type, different properties can be set:
    • New XML Document Dialog
      • Schema URL - Path to the schema file. When a file is selected, Oxygen analyzes its content and tries to fill-in the rest of the dialog;
      • 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 - The document namespace;
      • Prefix - The prefix for the namespace of the document root;
      • Root Element - Populated with elements defined in the specified schema, enables selection of the element to be used as document root;
      • Description - Shows a small description of the selected document root;
      • Add optional content - When selected, the elements and attributes that are defined in the XML Schema as optional, are generated in the skeleton XML document;
      • Add first Choice particle - When selected, the first element of an xs:choice schema element is generated in the skeleton XML document created in a new editor panel when the OK button is pressed.
    • New XSL Document Dialog
      • Stylesheet version - Stylesheet version number. Possible options: 1.0 and 2.0;
      • Generate stylesheet documentation - Generates the stylesheet documentation.
    • New XML Schema Document Dialog
      • Target namespace - Specifies the schema target namespace;
      • Namespace prefix declaration table - Contains namespace prefix declarations. Table information can be managed using the New and Delete buttons.
    • New Schematron Document Dialog
      • Schematron version - Specifies the Schematron version. Possible options: 1.5 and ISO.