## page was renamed from HelpCenter/Tips/DITA/ePublisher_9_3/XMetal_Integration
{{{#!rst
==================
XMetaL Integration
==================

XMetaL 5.0 is a great DITA authoring tool. Unfortunately, out of box, ePublisher is not aware of XMetaL's reusable component DTD, a specialization called ditacomponent. The procedure listed below enables ePublisher to process DITA content that takes advantage of XMetaL's reusable component feature.

Procedure
=========

1. Create a "Helpers" override area in your project directory::

     <project_dir>\Formats\Helpers

2. Copy the default DITA Open Toolkit install from the ePublisher
   install directory into your "Helpers" override directory.

   ePublisher Install Directory::

     C:\Program Files\WebWorks\ePublisher Pro\Helpers\dita-ot

   "Helpers" override directory::

     <project_dir>\Formats\Helpers

   The end result should be::

     <project_dir>\Formats\Helpers\dita-ot

3. Copy XMetaL 5 ditacomponent DTDs into the DITA Open Toolkit.

   NOTE:  XMetaL has given permission for us to redistribute the necessary files.  See `Attachments`_ below.

   Copy::

     C:\Program Files\XMetaL 5\Author\DITA\DITA_OT_DTD\dcspecialized-typemods.ent
     C:\Program Files\XMetaL 5\Author\DITA\DITA_OT_DTD\ditacomponent.dtd
     C:\Program Files\XMetaL 5\Author\DITA\DITA_OT_DTD\ditacomponent.mod

   to::

     <project_dir\Formats\Helpers\dita-ot\dtd

4. Update the DITA-OT XML catalog definition file::

     <project_dir>\Formats\Helpers\dita-ot\catalog-dita.xml

   Add the following at the bottom of the file before the final ``</catalog>``
   element::

     <!-- XMetaL Reusable Component Support -->
     <!--                                   -->
     <public publicId="-//XMETAL//DTD DITA Component//EN"
             uri="dtd/ditacomponent.dtd"/>
     <public publicId="-//XMETAL//ELEMENTS DITA Component//EN"
             uri="dtd/ditacomponent.mod"/>
     <public publicId="-//XMETAL//DTD DITA Component Specialized Typemods//EN"
             uri="dtd/dcspecialized-typemods.ent"/>

Attachments
===========
}}}

 * [[attachment:XMetaL 5.zip|XMetal 5.zip]]