Parent: Installation and Setup
Related information
Installation and Setup
 

Install the Structure Application

A DITA 1.1 structure application is provided as one possible option.

You are free to use your own structure application, but you may want to install the FM2DITA application to use for testing and review. We suggest using a DITA 1.1 structure application even if you are creating DITA 1.2 files. The FM2DITA processing tools don’t currently offer support for any DITA 1.2 features (keyref, conref ranges, etc.) so there is no need to use a DITA 1.2 application.

Whatever structure application you use, it should reference and be built on the ditabase model. Assuming that you’ll be generating multiple topic types from chapter FM files, you need to use an EDD model that supports multiple XML models. If you’re just writing one topic type, you can use a structure application that is specific to that topic type.

Note: For FrameMaker 7.2 users, menu items indicated on the StructureTools menu can be found on the File menu.

  1. Select a location where you’ll store your structure applications. The default location that FrameMaker uses is in the FrameMaker program folder at FrameMaker\Structure\xml. You can use that location or you may want to use a location outside of the program folder structure (current versions of Windows make it difficult to edit files in the program files area). For ease of use, we suggest creating a folder called structapps in the %appdata%\Adobe\FrameMaker\<ver> folder.

  2. Extract the contents of the FM2DITA_1.1_apps.zip file to the folder defined in step #1. This will create a folder named FM2DITA_1.1 that contains folders named dtd and Topic. These folders contain the Topic structure application as well as the DITA 1.1 DTD files used by the applications.

  3. Start FrameMaker and open the structure application definitions file (StructureTools > Edit Application Definitions).

  4. Open the Structure View window. In the structure application definitions file place the insertion point just after the Version element. When the insertion point is in the right location, you’ll see a black triangle pointing to the right in the Structure View window.

  5. Choose File > Import > File, then navigate to the structapps-stub_topic_1.1.fm file in the FM2DITA_1.1\Topic folder created earlier. Select the Import by Reference option and choose the Import button. In the next dialog accept the defaults and choose Import.

  6. Save the structapps.fm file, then choose StructureTools > Read Application Definitions.

  7. Close the structapps.fm file and exit FrameMaker.