| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!--Arbortext, Inc., 1988-2011, v.4002-->
|
|---|
| 3 | <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
|
|---|
| 4 | "reference.dtd">
|
|---|
| 5 | <?Pub Inc?>
|
|---|
| 6 | <reference id="plugin-xmlcatalog" xml:lang="en-us">
|
|---|
| 7 | <title>Extending the XML Catalog</title>
|
|---|
| 8 | <shortdesc>The XML Catalogs extension point is used to update the
|
|---|
| 9 | XML Catalogs used to resolve DTD or Schema document types, or to add
|
|---|
| 10 | URI mappings. This is required in order to support DITA specializations
|
|---|
| 11 | or new DITA document type shells.</shortdesc>
|
|---|
| 12 | <refbody>
|
|---|
| 13 | <section> <p>To do this, first create a catalog with only
|
|---|
| 14 | your new values, using the OASIS Catalog format, and place that
|
|---|
| 15 | in your plug-in. Local file references in the catalog should be relative
|
|---|
| 16 | to the location of the catalog. The following extension points are
|
|---|
| 17 | available to work with catalogs.</p><dl><dlentry>
|
|---|
| 18 | <dt><codeph>dita.specialization.catalog.relative</codeph></dt>
|
|---|
| 19 | <dt importance="deprecated"><codeph>dita.specialization.catalog</codeph></dt>
|
|---|
| 20 | <dd> <p>Adds the content of the catalog file defined in <codeph>file</codeph> attribute
|
|---|
| 21 | to main DITA-OT catalog file.</p> <note
|
|---|
| 22 | type="remember">The <codeph>dita.specialization.catalog</codeph> extension
|
|---|
| 23 | is deprecated. Use <codeph>dita.specialization.catalog.relative</codeph> instead.</note>
|
|---|
| 24 | </dd>
|
|---|
| 25 | </dlentry><dlentry>
|
|---|
| 26 | <dt><codeph>org.dita.pdf2.catalog.relative</codeph></dt>
|
|---|
| 27 | <dd> <p>Adds the content of the catalog file defined in <codeph>file</codeph> attribute
|
|---|
| 28 | to main PDF plug-in catalog file.</p> </dd>
|
|---|
| 29 | </dlentry></dl> </section>
|
|---|
| 30 | <example><title>Example</title><p>This example assumes that "<filepath>catalog-dita.xml</filepath>"
|
|---|
| 31 | contains an OASIS catalog for any DTDs or Schemas inside this plug-in.
|
|---|
| 32 | The catalog entries inside of <filepath>catalog-dita.xml</filepath> are
|
|---|
| 33 | relative to the catalog itself; when the plug-in is integrated, they
|
|---|
| 34 | will be added to the core DITA-OT catalog (with the correct path).</p><?Pub
|
|---|
| 35 | Caret -1?><codeblock><plugin id="com.example.catalog">
|
|---|
| 36 | <feature extension="dita.specialization.catalog.relative" file="catalog-dita.xml"/>
|
|---|
| 37 | </plugin></codeblock> </example>
|
|---|
| 38 | </refbody>
|
|---|
| 39 | </reference>
|
|---|
| 40 | <?Pub *0000002241?>
|
|---|
