Run the Installer Application

Extract the EXE from the ZIP archive and run it.

The DITA-FMx installer application is provided in a ZIP archive. Extract the executable from the archive and run it. The installer extracts and copies the required files to the FrameMaker\DITA-FMx-2 folder.

As part of the installation process, the installer modifies the maker.ini file. If you feel it is necessary, you may want to make a backup of this file before running the installer. If you are installing an update, see Installing a DITA-FMx Update.

The following files are installed:

ditafmx_<fmver>.dll - Authoring and publishing support plugin DLL.
ditafmx_<fmver>_app.dll - Import/export client DLL.
pt_updates.dll - The DLL that provides web access for the “check for updates” command.
ditafmx.chm - DITA-FMx User Guide online Help file.
ditafmx-ref-1.1.chm - DITA 1.1 Reference online Help file (for element-based context sensitive authoring help). Includes the special DITA-FMx elements.
ditafmx-ref-1.2.chm - DITA 1.2 Reference online Help file (for element-based context sensitive authoring help). Includes the special DITA-FMx elements.
DITA-FMx_Help_Source.zip - Source for the user documentation.
DITA-FMx_apps.zip - Structure application files for DITA 1.2.
LwDITA-FMx_apps.zip - Structure application files for Lightweight DITA.
ditafmx-ant.xml - Ant script that provides targets for the Current File option of the Generate Output command.
PROJECT.xml - Sample Ant script for the Selected Target option of the Generate Output command.
ditafmx-bookbuild.ini - The default book-build INI used by the Generate Book from Map (Book Build) process. Copy this file into the folder that contains the generated book file to customize the build process for that book. If no book-build INI file is found in the output folder, the settings in this default file are used.
filtergroups.ini - The default INI file used by the filtering groups feature of the Set Attributes command. Copy this file into the folder that contains the topic files to create project-specific filtering groups. If no filtergroups.ini file is found in the topic folder, the settings in this default file are used.
missing-images folder - Contains files named missing-image-break.<ext> and missing-image-inline.<ext>. Files are provided for all conceivable file types. If you a re using files of a type not provided, create them from a type provided. The _README.txt file in this folder explains why they are needed.
ditafmx-zip.exe - A ZIP archive creation utility provided by Info-ZIP. Used by the Create Archive command.
ditafmx-unzip.exe - A ZIP archive extraction utility provided by Info-ZIP. Used by the automated structure application installation process.

After extracting the new files, the installer updates the APIClients section of the maker.ini file with references to the plugin DLLs. The following lines are added (the numbers will vary based on the FrameMaker version: “160” is FM2020, “150” is FM2019, “140” is FM2017, “130” is FM2015, “120” is FM12, and so on):

ditafmx=Standard, ditafmx, DITA-FMx-2\ditafmx_160.dll, structured 
ditafmx_app=Standard, ditafmx_app, DITA-FMx-2\ditafmx_160_app.dll, structured

Important: As of DITA-FMx 2.0.07, the installer application modifies the maker.ini file to comment out references to the default DITA plugins; you no longer need to do this manually.

Note: On Windows Vista, 7, 8, or 10, when you run FrameMaker, the user data files (like the ditafmx.ini file) are created in a DITA-FMx-2 folder in the application data area (typically C:\Users\USERNAME\AppData\Roaming\Adobe\FrameMaker\16\DITA-FMx-2). Any “global” data files that you create (like filtergroups.ini and ditafmx-bookbuild.ini), that the documentation indicates should be in the FrameMaker/DITA-FMx folder should be created in this location as well. The DITA-FMx > Open DITA-FMx Folder command is useful for accessing this folder.

Once the installation has completed, you need to set up the structure applications before you can create and edit DITA files. Continue to DITA Structure Applications.