HomeStreek ResourcesClient AppsDeveloper ResourcesTalksHowTo Docs
 

Configuring Oxygen to Validate from Catalog-referenced DTDs

Audience

Users of the Oxygen XML editor.

Purpose

To enable Oxygen to validate documents whose DTDs are referenced in catalog files.

Prerequisites

  • Installed Oxygen XML Editor, either as standalone application or Eclipse plugin.

Configuring Oxygen to Validate from Catalog-referenced DTDs

Warning

============================================

This document has been superceded!

============================================

This document is no longer maintained at this location. It has been superceded by a more up-to-date document on the IST-ASAG site.

The new URL for this document is: http://ist.berkeley.edu/as/ag/tools/howto/oxygen-catalog.html

============================================

The Oxygen XML editor, whether used in the Eclipse IDE or in standalone mode, can be configured to locate DTDs from a catalog file rather than from direct references to the DTD on your filesystem or on the internet via a URL.

The example used in this HowTo document refers to catalog files for Forrest; on the Forrest site you can find some background information on Forrest-specific usage of catalog fles. A more general article on catalogs can be found on the Apache XML-Commons site.

Configuring Oxygen to use Catalog files from within Eclipse

Before you begin these steps, be sure you know where on your filesystem the catalog files that contain references of interest are located. Example: know where Forrest is installed on your system (as of Eclipse v. 3.0.2, the Forrest installation should be inside your Eclipse workspace, per this documentation); and that for the Streek project, extensions to the Forrest DTDs are kept in the file $CVSHOME/streek/src/documentation/resources/schema/catalog.xcat.

  • In Eclipse, navigate to the Preferences dialog (Window:Preferences)
  • In the Preferences dialog, navigate to Oxygen's XML Catalog settings pane (Oxygen:XML Catalog)
  • Add references to the XML Catalogs you wish to add. Examples:
    • If Forrest is installed in C:\workspace\forrest-0.6, the reference to Forrest's main catalog would be file:/C:/workspace/forrest-0.6/src/core/context/resources/schema/catalog.xcat
    • If your CVSHOME is C:\eclipse\workspace, the reference to Streek's extensions catalog would be: file:/C:/eclipse/workspace/streek/src/documentation/resources/schema/catalog.xcat
  • Close and restart Eclipse.

Configuring standalone Oxygen to use Catalog files

Open Oxygen, navigate to External Tools:Preferences:XML Catalog, and add references to the XML Catalogs you wish to add as described in the section on configuring Oxygen from within Eclipse, above.