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 Author, follow these steps:

1. Click the New button on the toolbar or select File ⇒ New ⇒ Other ⇒ Oxygen XML Author.

   Tip

   You can also select New from Templates to create a document based upon predefined templates or custom templates.

   Result: The New Document wizard is displayed with all the supported document types.

2. Select the type of document that you want to create.
3. Click the Next button.

   Result: The next wizard page allows you to select a path where you want to store the new file and for some document types it includes some customization options. If you selected XML File or XML Schema (XSD) File for the type of document, you need to select the storage path and click Next again to reach customization options.

4. After configuring the options in this wizard, click Finish to create the file. If the Open file for editing when done option is selected, the new file will be opened in the appropriate editor.

XML File Type

New XML File Configuration Options

If you selected XML File for the type of document you want to create, the wizard will include the following options:

• URL - Specifies the path to the schema file. When you select a file, Oxygen XML Author 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 pane - 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 generates the first element of an xs:choice schema element in the skeleton XML document. Oxygen XML Author creates this document in a new editor panel when you click Finish.

XSL Stylesheet File Type

New XSL Document Configuration Options

If you selected Stylesheet (XSL) File for the type of file you want to create, the wizard 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 (XSD) File Type

New XML Schema Configuration Options

If you selected XML Schema (XSD) File for the type of file you want to create, the wizard will include the following options:

• Default XML Schema version - Select this option to use 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 Options

If you selected Schematron File 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 Author, the support for Schematron 1.5 is deprecated. It is recommended to use ISO Schematron instead.