DITA-FMx User Guide

Cloning the Default Structure Applications

The first step in customizing the layout or formatting of a structure application is to create your own application; the easiest way to create your own is to clone the existing apps.

First, copy the FrameMaker\Structure\XML\DITA-FMx folder (with all subfolders included) to a new folder name, for our purposes here, we’ll call it DITA-MyCo. In the new DITA-MyCo folder are the three application folders (Topic, Map, and Book), and the DTD folder. You’ll be modifying files in the application folders, and leaving the DTD folder as it is (unless you’re specializing, which we won’t go into here). You’ll want to make the same initial changes to each of the applications (replace “<app>” with the Topic, Map, or Book application in the steps below).

  1. From the new DITA-MyCo\<app> folder open the <app>.edd.fm file in FrameMaker. At the top of the file, you’ll see a line that says “Structured Application: DITA-FMx-<app>”, change that to “DITA-MyCo-Topic”. Save this file, but leave it open for now.
  2. From the DITA-MyCo\<app> folder open the <app>.template.fm file in FrameMaker. Choose File > Import > Element Definitions, select the EDD from the list and choose Import.
  3. Save and close the template, then save and close the EDD.
  4. From the DITA-MyCo\<app> folder open the structapps-stub_<app>.fm file in FrameMaker. Change all instances of “DITA-FMx” to “DITA-MyCo”. This involves modifying the text of a variable. You’ll actually want to create a new variable and use that, don’t just modify the content of the existing variable; if you modify the content of the variable, it will mess up other applications since this “stub” file is imported into the structure application definitions file.
    1. Open the Variable dialog (Special > Variable).
    2. Select “DITA-FMx-Path” from the list and choose Edit Definition.
    3. In the Edit user variable dialog, change the name from “DITA-FMx-Path” to “DITA-MyCo-Path”, then in the Definition field change “DITA-FMx” to “DITA-MyCo”. Then choose Add then Done. Choose Done again in the Variables dialog.
    4. Double-click the first DITA-FMx-Path variable and in the Variables dialog select “DITA-MyCo-Path” and choose Replace.
    5. Now copy and paste this new variable overall instances of it in the stub file (in the Template, DTD, Read/Write Rules, and numerous places in Entity Locations).
  5. Save and close the stub file.
  6. Now open the structure application definitions file with the Structure Tools > Edit Application Definitions command (on FM7.2 the Structure Tools menu is on the File menu).
  7. Place the insertion point just after the Version element (use the Structure View window to see this location easily), and choose File > Import > File. Navigate to the new structapps-stub_<app>.fm file and select it. In the Import Text Flow By Reference dialog, accept the defaults and choose Import.

Once you have followed those steps for each application, you’ll have created a “clone” of the default applications and are now ready to customize them as needed.