sample_oxygen.catalog #1

  • //
  • guest/
  • paul_allen/
  • p4convert-maven/
  • docs/
  • perforce/
  • sample_oxygen.catalog
  • View
  • Commits
  • Open Download .zip Download (1 KB)
<?xml version="1.0" encoding="UTF-8"?>
<!--
  This is a sample catalog that can assist in resolving computed
  include paths in GUI XML editors, such as oXygen Editor.

  The entries below need to be customized to reflect where the
  contents within doc_build exist on your system.
-->
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD XML Catalogs V1.1//EN" "http://www.oasis-open.org/committees/entity/release/1.1/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">

  <!-- redirect @common-xml@ to correct location -->
  <rewriteSystem
    systemIdStartString="file://@common-xml@"
    rewritePrefix="file:///path/to/doc_build/perforce/common_xml"
  />
  <rewriteURI
    uriStartString="file://@common-xml@"
    rewritePrefix="file:///path/to/doc_build/perforce/common_xml"
  />

  <!-- redirect @guides-dir@ to correct location -->
  <rewriteSystem
    systemIdStartString="file://@guides-dir@"
    rewritePrefix="file:///path/to/documentation"
  />
  <rewriteURI
    uriStartString="file://@guides-dir@"
    rewritePrefix="file:///path/to/documentation"
  />
</catalog>
# Change User Description Committed
#1 13895 Paul Allen Copying using p4convert-docbook
//guest/perforce_software/doc_build/main/perforce/sample_oxygen.catalog
#3 12841 eedwards Update the sample oXygen catalog to be more
Workshop-friendly.
#2 12798 eedwards Follow-on to @935187: handle @guides-dir@ in
addition to @common-xml@.

Also, fixup an xml:id problem.
#1 12797 eedwards Update the handling of @common-xml@ paths to permit
using an XML Catalog file to resolve these references in
the oXygen XML editor.

A sample catalog file is included, which needs to be
customized on your system to reflect the actual local
filesystem path to the common_xml directory, and then
oXygen needs to be configured to use this catalog file.
Once these steps are done, oXygen should be able to
validate the guides.

Each guide that uses this facility has been updated
accordingly.