New Document Wizard

New Document Wizard

The New Document wizard allows you to create various types of documents and provides some options that help you to configure the new document. To use this wizard to create a new document in Oxygen XML Editor plugin, follow these steps:

1. Click the New button on the toolbar or select File ⇒ New.

   Result: The New Document wizard is displayed and it groups the supported document types in the following categories:

   • Recently Used - Contains the list of the most recently used file types.
   • New Document - Contains the list of all supported document types. This list includes XML, CSS, .
   • Global Templates - Contains the list of predefined templates as well as user-defined custom templates. You can create your own custom file templates and add them to the templates folder of the Oxygen XML Editor plugin installation directory. You can also specify an additional directory to use for the templates in the Document Templates preferences page.
   • Framework Templates - Contains the list of templates defined in the Document Type configuration dialog box (Templates tab) for each framework.

2. Select the type of document that you want to create.
3. If you want to use the default settings in the creation process, select Create at the bottom of the dialog box.

   Result: The document is created using the default settings and the new file is opened in the appropriate editor.

4. If you want to configure properties before creating the file, select Customize. This action is available for XML, XML Schema, Schematron, and XSL documents.

   Result: A new file configuration dialog box is opened that allows you to customize various options, depending on the document type you selected. After configuring the options in this wizard, click Create to create the file and open it in the appropriate editor.

XML Document File Type

New XML Document Configuration Dialog Box

If you selected XML Document for the type of file you want to create and selected the Customize option, the configuration dialog box will include the following options:

• Schema URL - Specifies the path to the schema file. When you select a file, Oxygen XML Editor plugin analyzes its content and tries to fill in 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 Editor plugin generates the first element of an xs:choice schema element in the skeleton XML document. Oxygen XML Editor plugin creates this document in a new editor panel when you click OK.

XSLT Stylesheet File Type

New XSLT Stylesheet Configuration Dialog Box

If you selected XSLT Stylesheet for the type of file you want to create and selected the Customize option, the configuration dialog box will include the following options:

• Stylesheet version - Allows you to select the Stylesheet version number. You can select from: 1.0, 2.0, and 3.0.
• Add documentation annotations - Enable this option to generate the stylesheet annotation documentation.

XML Schema File Type

New XML Schema Configuration Dialog Box

If you selected XML Schema for the type of file you want to create and selected the Customize option, the configuration dialog box will include the following options:

• 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 - Allows you to specify the schema target namespace.
• Namespace prefix declaration table - This table contains namespace prefix declarations. Table information can be managed using the New and Delete buttons.

Schematron File Type

New Schematron Configuration Dialog Box

If you selected Schematron for the type of file you want to create and selected the Customize option, the configuration dialog box will include the following option:

• Schematron version - Specifies the Schematron version. Possible options: 1.5 (deprecated) and ISO.

  Note

  Starting with version 16.0 of Oxygen XML Editor plugin, the support for Schematron 1.5 is deprecated. It is recommended to use ISO Schematron instead.