Task 3: Conversion Processing

The bulk of the FM2DITA automation happens here.

Verify that the fm2dita.ini file is set up properly.

Note: Between each step or as needed, remember to save all files.
  1. Open the book and all files from Task 2: Structured Conversion.
  2. Place focus on the book file, choose Pubs-Tools > FM2DITA > Import Template and EDD.
    • This imports the template and EDD associated with the structure application specified by the TopicAppName parameter in the fm2dita.ini file.
  3. If the file naming relies on chapter numbering, set up chapter numbering in the book.
  4. With focus on the book, choose Pubs-Tools > FM2DITA > Check for Topic Collisions
    • If collisions are reported, fix the title text before continuing.
    • If filenames are based on topic IDs, you’ll need to run Assign IDs to Topics before running this command.
  5. Run the following FM2DITA commands on the book in the order shown.
    • Be sure to re-focus the book with each command and watch the console for errors.
    • Review the documentation to decide which commands are useful for your processing. In general it should be fine to run a command that isn’t needed.
    • The order of the commands is important. Run commands higher on the menu before those lower on the menu.
    • Assign IDs to Topics in Book - Required for all conversions
    • Unwrap Elements in Book
    • Condition to Attribute in Book
    • Fix Images in Book
    • Fix Tables in Book
    • Fix Cross-refs in Book
    • Map Hypertext Markers in Book
    • Related Links to Reltable in Book
    • Flatten Cross-refs in Book
    • Move Markers in Book
    • Variables to Conrefs in Book
    • Merge Code Lines in Book
    • Tab to Spaces in Book
    • Delete Invalid Attributes in Book - Typically required to delete the Id and Idref attributes
    • Delete Unstructured Markers in Book - Typically required to delete Cross-Ref markers
    • Delete Empty Elements
  6. Save and optionally close all files in the book.
    • Place focus on book, press Shift and click File > Save All Files in Book
    • Place focus on book, press Shift and click File > Close All Files in Book
  7. Optionally save the out folder to a new name (out-2?) to make it easier to roll back to this point in case something goes wrong.