Configuring a DITA speciallization for use in Content Editor

You can configure Content Editor to use your DITA specialization in the form of XSD's.

About this task

Content Editor needs DITA specializations in the form of XML Schema's (XSD's). Content Manager keeps these XSD's in the same location on the server as the DTD's: $\Web\Author\ASP\DocTypes.

Procedure

  1. Copy the XSD's for the specialization to the DocTypes folder on the Content Manager
  2. Modify the catalog-mapping.xml file to include the mapping from the DTD to the Schema file.
    <match rootelement="myTopic" dtdpublicid="-//Example//DTD DITA myTopic//EN" dtdsystemid="dita-oasis/1.2/example/dtd/myTopic.dtd" xsdsystemid="" xsdname="urn:oasis:names:tc:dita:xsd:myTopic.xsd" xsduri="myTopic.xsd" />
  3. Add the new XSD's to the catalog used for Schema resolving: catalog-dita-xsds.xml

    <system systemId="myTopic.xsd" uri="myTopic.xsd" xml:base="dita-oasis/1.2/example/xsd/"/>
    <system systemId="urn:oasis:names:tc:dita:xsd:myTopic.xsd" uri="myTopic.xsd" xml:base="dita-oasis/1.2/example/xsd/"/>
    <uri name="myTopic.xsd" uri="myTopic.xsd" xml:base="dita-oasis/1.2/example/xsd/"/>
    <uri name="urn:oasis:names:tc:dita:xsd:myTopic.xsd" uri="myTopic.xsd" xml:base="dita-oasis/1.2/example/xsd/"/>
  4. If the specialization uses a different root element, add an XSL file for rendering the document in Content Editor. The location of the XSL file is $\Web\Author\ASP\Editors\Xopus\config\xsl. To use the out of the box rendering from Content Editor, include a reference to topic.xsl in your XSL file.

    <xsl:include href="topic.xsl"/>

  5. Add configuration for any new elements introduced by your specialization in the Content Editor configuration file dita-config-custom.xml. This file is in $\Web\Author\ASP\Editors\Xopus\config. For a reference, take a look at the out of the box configuration in dita-config.xml. As specialized elements inherit the configuration applied to the elements they are based on, the most important thing to configure is the element name. For more information, look at the SDL LiveContent Create Configuration Reference.
    
    <x:nodeConfig>
      <x:node match="myTopic">
        <x:name>My Topic</x:name>
      </x:node>
    </x:nodeConfig>