XML

XML Catalog

The XML Catalog preferences panel is opened from menu WindowPreferencesAuthor+XML+XML Catalog

Figure 17.32. The XML Catalog preferences panel

The XML Catalog preferences panel

The Prefer option is used to specify if <oXygen/> will try to resolve first the PUBLIC or SYSTEM reference using the specified XML catalogs. If a PUBLIC reference is not mapped in any of the 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 messages of the 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 with the XML catalogs set in the application.

Unresolved entities

Only the messages that track the failed attempts to resolve URI references are displayed.

All messages

The messages of both failed attempts and successful ones are displayed.

If the Process namespaces through URI mappings for XML Schema option is not checked only the schema location of an XML Schema that is declared in an XML document is searched in XML catalogs. If the option is checked the schema location of an XML Schema that is declared in an XML document is searched in XML catalogs and if the schema location is not resolved the namespace of the schema is also searched in the XML catalogs.

If the Use default catalog option is checked the first XML catalog which <oXygen/> will use to resolve system IDs at document validation and URI references at document transformation will be a default built-in catalog which maps such references to the built-in local copies of the local DocBook and TEI frameworks and the schemas for XHTML, SVG and JSP documents.

You can also add or configure catalogs for each of the defined document types from Document Type Association preferences page.

When you add/delete or edit an XML catalog to/from the list you must sometimes reopen the current edited files which use the modified catalog so that the changes take full effect.