Documentation Center

Preparing and synchronizing the specialized configuration files

You must prepare and synchronize the specialized configuration files from the Content Manager server so you can use XMetaL with Content Manager documents and browse the repository instead of the filesystem.

About this task

To allow XMetaL to work in combination with the Authoring Bridge, the configuration files delivered with a standard installation of XMetaL were slightly modified: additional code was added to make sure you can browse the repository instead of the file system when inserting <topicref> elements, <image> elements, <xref> elements, <link> elements, etc.

The configuration files are stored on the server in the folder Web\Author\ASP\ClientConfig\XMetaL\{XMetaLVersion}-CRCL\LocalStorage\DocTypes\dita-oasis\1.2.

To configure your specialized DTD in XMetaL, you must create additional files. The configuration files differ from the files in the XMetaL XACS folder. Additional code was added to ensure you can browse the repository instead of the file system when inserting topicref elements, image elements, xref elements, link elements, etc.

Procedure

  1. On the server, navigate to the folder $Web\Author\ASP\ClientConfig\XMetaL\{XMetaLVersion}-CRCL\LocalStorage\DocTypes\dita-oasis\1.2. Note that the filestructure here needs to be the same as the one under ASP\Doctypes\dita-oasis\1.2
  2. Copy all configuration files for the base type (~ the type used to create your specialization) and rename them using the path and filename of your specialized DTD.
    • If you specialized from topic, task, reference, concept, ditabase, copy all technicalContent\dtd\topic*.* files.
    • If you specialized from map, copy all technicalContent\dtd\map*.* files.
    • If you specialized from bookmap, copy all\bookmap\dtd\bookmap*.* files.
    For example: If you specialize a DITA topic and you name the DTD function.dtd:
    Copy the file…Rename the file as…Use (see XMetaL documentation for more information)

    topic.css

    function.css

    Indicates styling in XMetaL

    topic.ctm

    function.ctm

    Describes the xml element options

    topic.js

    function.js

    Optional. DTD specific code (Only used in 3.8.0 to suppress duplicate 'SDL Trisoft' menu)

    topic.mcr

    function.mcr

    Adjusted XMetaL macro files to call Content Manager bridge dialogs for inserting images, hyperlinks, links,…

    topic.tbr

    function.tbr

    Describes the menu structure

    topic_structure.css

    function_structure.css

    Indicates additional structure styling in XMetaL on top of the basic css (topic.css)

    topic-specialized.css

    function-specialized.css

    Indicates additional specialized styling in XMetaL on top of the basic css (topic.css)

  3. Open the file <specialized DTD>.js in a text editor (for example, notepad) and replace all occurrences of the base type (for example, topic, task, etc.) with the file name of your specialized DTD.
    For the example above, you would replace the word topic with function in the file function.js.
  4. Open the file <specialized DTD>.css in a text editor and replace "<base type>-specialized.css" with "<specialized DTD>-specialized.css".
    In the example, you would open the file function.css and replace topic-specialized.css with function-specialized.css.
  5. Optional: if you want to apply special styling to specialized elements in XMetaL, you must also modify the file function-specialized.css. For more information about modifying the css, refer to XMetaL's documentation.

Results

The specialization is now ready for synchronization with XMetaL.