Developing Custom Structure Applications

Once you’re comfortable with the features in DITA-FMx, you’ll surely want to create your own custom structure applications that apply your house style to your DITA documents.

In FrameMaker, all of the formatting and page layout applied to XML files is done by the selected structure application. A structure application (also called a “structure app” or just “app”) is made up of the following components:

There are many ways to develop and maintain structure applications. DITA-FMx is set up to work with three types of apps, a Topic app and a Map app (both used for authoring) and a Book app (used for printing and PDF generation). If you want to control the way your DITA files are printed, you will want to modify the Book app. If you want to modify the structure or add/remove elements, you’ll need to modify both the Topic and Book apps (and possibly the Map app). The default DITA-FMx application folder structure puts the files for all three of these apps into Topic, Map, and Book folders under a main folder named “DITA-FMX_1.2.” We find this folder structure to be the most efficient, but you are free to devise any structure that works for your needs.

When creating your own custom structure applications, you can either start by cloning the existing default DITA-FMx apps or by creating your own from scratch. The cloning method is the easiest and least likely to have errors, but you can do which ever works best for you.

Important: You may be tempted to make minor modifications to the default DITA-FMx apps. We strongly recommend that you maintain an instance of the DITA-FMx structure applications in their original form. Because these applications work properly with DITA-FMx, as you customize/build your own apps, you may need to refer back to the originals in case something goes wrong (which it often does).