Tips for migrating from default FrameMaker DITA to DITA-FMx.
In general, there should be very little migration effort going from the default DITA support in FrameMaker 8 or 9 (FM-DITA) to DITA-FMx. Because both DITA authoring environments create valid DITA files, you can open and edit files created by the other environment just as you can open and edit files created in different authoring tools such as XMetaL or Oxygen.
If you’ve customized the default FM8 or FM9 structure applications and want to continue using those customizations in DITA-FMx, there may be some work required to migrate the apps since DITA-FMx provides features that do not exist in FM-DITA. For a complete listing and description of the DITA-FMx structure application requirements, refer to the Required Element Definitions topic.
You cannot migrate FM10 DITA 1.2 applications for use in DITA-FMx 1.1 (DITA-FMx 1.1 supports the DITA 1.1 specification, even on FM10). DITA-FMx 2.0 will support the DITA 1.2 specification, and should be available in the near future. If you want to migrate FM10 DITA 1.1 applications for use with DITA-FMx, you should be able to follow the suggestions for migrating the FM8/9 apps.
If you want to just “give it a try” to see what breaks, that’s fine (you’re not going to break anything). The only thing that’s absolutely required is that you change the “Use API Client” node in the application definition so it uses the “ditafmx_app” client name instead of “ditafm_app.” You’ll need to do this for any structure application that you want to use with DITA-FMx. (If you try to use these apps without changing the UseApiClient node, you will get the following error message when opening a DITA file: “Translator client (ditafm_app) was not found.”) Once this is done, change the application names in the DITA Options dialog, and give it a whirl.
If you’re migrating from FM8-DITA, which supports DITA 1.0, keep in mind that because DITA-FMx 1.1 supports DITA 1.1, there will be significant differences in the EDDs. You can continue to use DITA 1.0 apps in DITA-FMx 1.1 as long as you provide certain element definitions (described below).
If you’re migrating from FM9-DITA, the general EDD structure will be virtually identical to the DITA-FMx structure, other than the special “fm-*” elements. Some of these elements are required and others are more of a convenience.
Also, it may be useful to note that FM8-DITA provided a Book application (for building a book from a map), while the FM9-DITA does not. In FM9-DITA the book-building process uses the Topic application when building a book. DITA-FMx requires a separate Book application.
The following items are significant migration points, refer to the Required Element Definitions topic for a complete list of elements specific to DITA-FMx.