Specifying XML Catalogs

Serna fully supports OASIS XML Catalogs (Committee Specification 06 Aug 2001).

On opening a document, DTDs, Schemas, stylesheets and other resources can be found with the help of XML catalogs:
  • The main catalog common for all document types is located at sernaInstallationPath\xml\catalog.xml.

    The path to the main catalog is specified in the Preferences Dialog.

  • Template-specific catalogs are located in sernaInstallationPath\plugins\ <PLUGIN_NAME> directories.

    Paths to most template-specific catalogs are specified in corresponding document templates ( *.sdt files). Paths to some template-specific catalogs are specified in the main catalog.

When you open a document of a particular type, the path to the template-specific XML catalog is taken from the corresponding document template. If the path to an XML catalog is not specified in a document template, or you need to add some more XML catalogs for all document types, you can list them in the Preferences Dialog. To specify paths to XML catalogs, do the following:

  1. Call up the Preferences Dialog.

    To call up the Preferences Dialog, choose Tools > Preferences .

  2. Select the XML Catalogs tab.

    Figure 1. XML Catalogs tab.



  3. Select the Use XML catalogs radio button.
  4. Specify paths to XML catalogs.

    Type paths to XML catalogs in the Catalogs field. Or you can click the Add button to browse for a catalog in the Choose catalog(s) Dialog.

    Note:

    Paths to multiple catalogs must be separated by semicolons on Windows and by colons on Linux and Mac OS X.

    Note:

    The value of the variable $XML_CATALOG_FILES is empty by default. You can create a system variable $XML_CATALOG_FILES and list XML catalogs as its value. Catalogs that come first override those following.

    Important:

    It is also possible to specify an XML catalog file only for a particular document template. See Document Template Properties, xml-catalogs property.

  5. Specify the default match mode for DTD search path.

    In the DOCTYPE of a document, DTD is referenced via a public identifier (PUBID) and/or a system identifier (SYSID). It is possible to select the default match mode for DTD search paths:

    • To set the Public match mode as default, select the Public radio button.

    • To set the System match mode as default, select the System radio button.

    Note:

    Alternatively, the DTD search path can be specified explicitly without XML Catalogs use. Note that this approach works for DTD search only and does not allow Serna to search for Schemas and stylesheets. For details, see Specifying DTDs Locations.

  6. Click the Apply button to apply the settings.
  7. Click the Close button to close the dialog.
Related tasks
Specifying File Types For Opening In Serna
Specifying XML Files Search Path
Specifying DTDs Locations