XML Catalog

To open the XML Catalog preferences page, go to Options > Preferences > XML > XML Catalog.

The following options are available:

Prefer is used for specifying if Oxygen XML Author tries to resolve first the PUBLIC or SYSTEM reference from the DOCTYPE declaration of the XML document. If PUBLIC is preferred and a PUBLIC reference is not mapped in any of the XML catalogs then a SYSTEM reference is looked up.
When using catalogs it is sometimes useful to see what catalog files are parsed, if they are valid or not, and what identifiers are resolved by the catalogs. The Verbosity option selects the detail level of such logging messages of the XML catalog resolver that will be displayed in the Catalogs view at the bottom of the window:
- None - No message is displayed by the catalog resolver when it tries to resolve a URI reference, a SYSTEM one or a PUBLIC one with the XML catalogs specified in this panel.
- Unresolved entities - Only the logging messages that track the failed attempts to resolve references are displayed.
- All messages - The messages of both failed attempts and successful ones are displayed.
If Resolve schema locations also through system mappings is enabled, Oxygen XML Author analyzes both uri and system mappings in order to resolve the location of schema.
If Process namespaces through URI mappings for XML Schema is selected then the target namespace of the imported XML Schemas is resolved through the uri mappings. The namespace is taken into account only when the schema specified in the schemaLocation attribute was not resolved successfully.
If the Use default catalog option is checked the first XML catalog which Oxygen XML Author will use to resolve references at document validation and transformation will be a default built-in catalog. This catalog maps such references to the built-in local copies of the schemas of the Oxygen XML Author frameworks: DocBook, DITA, TEI, XHTML, SVG, etc.

You can also add or configure catalogs at framework level in the Document Type Association preferences page.

When you add, delete or edit an XML catalog to / from the list, reopen the currently edited files which use the modified catalog or run the Validate action so that the XML catalog changes take full effect.