In order for FrameMaker to properly import and export DITA files, you must have structure applications that support the authoring of topic and map files. DITA-FMx provides both of these applications as well as a structure application for book processing. If you want to customize the appearance of the templates or change the elements supported (adding through specialization or removing unwanted elements), you should clone the provided structure application folders and modify the cloned versions.
If you are upgrading from the App Pack, and want to continue using those structure applications (or your customized version), you’ll need to edit the “stub” files for those applications and change the “Use API Clients” element so it references the client “ditafmx_app” instead of “ditafm_app.” Or, if you want to use the new structure application that are provided with DITA-FMx, you may want to delete the old ones to eliminate possible confusion.
Follow these steps to install the structure applications provided with this version of DITA-FMx:
Extract the contents of the DITA-FMx_apps.zip file to the FrameMaker\Structure\xml folder. This will create a folder named DITA-FMx that contains folders named Book, dtd, Map, and Topic. These folders contains the three structure application as well as the DITA 1.0 DTD files used by the applications.
Make a backup copy of your current structure application definitions file (typically found at FrameMaker\Structure\structapps.fm. Store this file in a safe location before making modifications.
Start FrameMaker and open the structure application definitions file (
).In the structure application definitions file place the insertion point just after the Version element.
Choose structapps-stub_topic.fm file in the DITA-FMx\Topic folder created in step 1. Select the Import by Reference option and choose the Import button. In the next dialog accept the defaults and choose Import.
, then navigate to theRepeat step 4 for the “structapps-stub” files in the DITA-FMx\Map and DITA-FMx\Book folders.
Save the file, then choose
.Close the file and exit FrameMaker.
Restart FrameMaker and run the DITA-FMx-Topic for the DITA Topic Application, DITA-FMx-Map for the DITA Map Application, and DITA-FMx-Book for the DITA Book Application.
command and selectIf you plan to make use of the DITA Open Toolkit for generating output, see Setting Up to use the Generate Output Command.