On 8/9/21 9:04 PM, Gale Jaramillo /6358 wrote:

My company uses specialized map and topic DTDs for DITA.

The naming convention is company-map.dtd, company-topic.dtd, etc.

The problem is when I try to open a topic or map, XML Mind says it cannot find the file specified (pointing to the custom dtd). The DTDs are not much different than the standard ones coming with XMLMind.

Is there a simple way to handle this using app configuration settings?


Sure.

1) Edit attached XML catalog: omnicell_catalog.xml

A) Attributes publicId="-//OASIS//DTD DITA Topic//EN", publicId="-//OASIS//DTD DITA Map//EN" are the standard DITA public IDs. Change these public IDs if needed to. (These public IDs are used by the <!DOCTYPE> declaration found at the beginning of your DITA documents.)

B) Make attribute uri point to your company-map.dtd, company-topic.dtd, etc. Use absolute or relative URIs, not file paths. Example: use "file:/C:/foo/bar.dtd", not "C:\foo\bar.dtd".

C) Add more entries if you use other kind of topics or maps, like concept, task, etc.

2) Copy modified omnicell_catalog.xml (file name must end with "catalog.xml") to XXE_user_preferences_dir/addon/

---
XXE user preferences directory is:

    $HOME/.xxe9/ on Linux.

    $HOME/Library/Application Support/XMLmind/XMLEditor9/ on the Mac.

%APPDATA%\XMLmind\XMLEditor9\ on Windows. Example: C:\Users\john\AppData\Roaming\XMLmind\XMLEditor9\.

If you cannot see the "AppData" directory using Microsoft Windows File Manager, turn on Tools>Folder Options>View>File and Folders>Show hidden files and folders.
---

3) Delete XMLmind XML Editor's Quick Start Cache:

XXE_user_preferences_dir/cache/

otherwise XMLmind XML Editor will not "see" your omnicell_catalog.xml

4) Start XMLmind XML Editor and select "Help|About XMLmind XML Editor" to check that your "omnicell_catalog.xml" is listed in the "XML catalogs" section before stock "dita/catalog.xml".

How this works is explained in XMLmind XML Editor - Configuration and Deployment, 1. Dynamic discovery of add-ons, http://www.xmlmind.com/xmleditor/_distrib/doc/configure/addon_discovery.html

<?xml version="1.0" ?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
         prefer="public">
  
  <public publicId="-//OASIS//DTD DITA Topic//EN"
          uri="topic.dtd"/>
  
  <public publicId="-//OASIS//DTD DITA Map//EN"
          uri="map.dtd"/>
  
</catalog>
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to