Documentation Center

Installing new or updated DTDs on the server

If you want to add a new DTD or modify an existing DTD, you need to copy all the relevant files to the server on which Content Manager is installed. The next time that a user connects to the repository, the updated files are synchronized to the client application.

Content Manager keeps all DTDs in a central location on the server: $\Web\Author\ASP\DocTypes.

These DTDs are used by all components of the system:
  • Content Manager: to validate XML files that are checked in to the repository
  • XML editors: to allow authors to insert the correct elements at a given location.
  • DITA-OT: to make sure that documents can be published through the DITA-OT

Example

For example, if you want to install a new DITA specialization on the server, you must copy the DTD plus all referenced files to the server. In the example, the DTD function.dtd also references the files function.mod and dialectDomain.ent. Because it is a OASIS DITA 1.1 specialization, you must copy the files into the folder: $\Web\Author\ASP\DocTypes\doctypes\dita-oasis\1.1.

DTDs and XML editors

DTDs, used by XML editors as XMetaL and Arbortext Editor must be installed on the server first and are synchronized to the client so if you want to use a new DTD or update an existing one, the DTDs must be copied to the correct location on the server. The next time a user connects to the repository, these updates are automatically synchronized to the client.

DTDs and DITA-OT

To make sure that the DITA-OT is using the correct copy of the DTDs, the catalog file delivered with the DITA-OT has been customized to indicate the location of the DTDs as described above. This file can be found on the server: $\App\Utilities\DITA-OT\InfoShare\catalog-dita_template.xml.

<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog" prefer="public">
  <nextCatalog catalog="../../../../Web/Author/ASP/DocTypes/catalog.xml" />
</catalog>