1.03 - 30 April 2016

New Features

New preconversion tools
  • Book to Doc - Creates a single FM file from all files in a book.

  • Struct Cross-refs to Marker Cross-refs - Relinks structure-based cross-references to marker-based cross-references.

  • Fix Cross-ref Formats - Strips leading/trailing spaces from Cross-ref formats.

  • AFrame to Raster - Generates raster images from anchored frames that contain multiple graphic objects.

  • List Import/Export Filters - Generates a list of all import and export filters currently available in FrameMaker.

Updated preconversion tools
  • Retag Paras - Allows the use of multiple retag para groups.

Removed preconversion tools

Replaced the Extract Art comand with AFrame to Raster.

fm2dita.ini file location changes

The fm2dita.ini file is now located by checking the current directory (the directory with the file or book being processed), then each parent directory. If it is not found the “default” fm2dita.ini file is used (the one in the Pubs-Tools folder). This change allows you to maintain just one instance of an fm2dita.ini file for each project rather than needing to copy it to multiple folders.

New or changed fm2dita.ini parameters
  • General/AssignIdElems - new
  • General/TopicElems - changed default value to “” (nothing), now checks for @class contains ”topic/topic”.
  • General/StopWords - added support for stopwords file
  • General/FmDpiVal - new
  • Added new AFrameToRaster section with the following parameters: ImageType, ImageFilenameTemplate, ImagePath, ImageDpi, and ConvertTypes.
Modified handling of lists in fm2dita.ini parameters

For “space-delimited” lists in fm2dita.ini parameters, if you need to use an alternate delimiter (other than the space character), use this new syntax:

[<char>]<char-delimited string>

Where <char> is the new delimiter enclosed in square brackets. For example, to use a comma as the delimiter, use the following:

[,]first item,second item,third item

New building blocks and modifiers
  • <$IMG-DOCNAME> the document name (for AFrame to Raster command)
  • <$IMG-IMGNAME> the first image file name in anchored frame [may be null] (for AFrame to Raster command)
  • <$IMG-COUNT> the nth aframe processed (for AFrame to Raster command)
  • <$VAR(varname)> value of the varname variable (for Map Hypertext Markers command or elsewhere)
  • <$MARKERTEXT> value of the current marker’s marker text (for Map Hypertext Markers command)
  • <$LINKTEXT> value of the current marker’s link text (for Map Hypertext Markers command)
  • Added “split” building block modifier. [<index><splitchar>S] where <index> is 1-based, <splitchar> is a single character.
Retag Paras command updates

The Retag Paras command can now make use of multiple groups of rules for retagging paragraphs. This lets you define collections of rules that might be run for different situations or different types of content. Details are available in the Retag Paras topic.

Map Fix Images command updates

Added support for “fmdpi” in Fix Images command. If new INI parameter General/FmDpiVal is set, it assigns @outputclass='fmdpi:VAL', otherwise sets values for @height and @width attributes.

Map Hypertext Markers command updates

Added support for gotolink filename:newlink Hypertext markers. This assumes that all files are open at run time. It is possible to match on incorrect/duplicate file names, so use with care.

New API commands
  • RELLINKS-TO-RELTABLE

  • FLATTEN-CROSS-REFS

  • BOOK-TO-DOC

  • STRUCT-MARKER-CROSSREFS

  • FIX-CROSSREF-FMTS

Updated API commands
  • RETAG-PARAS - added optional <groupName> parameter.

Sample File and Structure Application Updates

Sample file changes

The conversion table and FM files have been updated to support conversion of related links to reltable entries.

Bug Fixes / Minor Updates

Fixed problems with stop words

Stop word processing should be working properly now.

If the result of processing leaves an empty string, now sets the string to the first “word.”

Fixed “splitchar” operator for $URI building blocks

Now URI-encodes after the split is performed.

Report and log updates

Catalog Report command on FM12 and later, could go into infinite loop. This has been fixed.

Report and log files now display in a more user-friendly manner on FM12 and later.

Table to Text fixes

Fixed Table to Text command so it doesn’t fail when multiple tables are anchored to the same paragraph. Also no longer deletes content in paragraphs that anchor tables that are deleted.

Properly converts table titles.

Fix Images fixes

Fixed Fix Images command so it moves <image> elements from <title> elements to the next sibling of the <title>.

If fig/@Id is empty, check the parent of fig for an @Id, if found, move it to fig/@Id.

No longer creates an empty @align attribute.

Book processing of images has been updated to “fix” all images.

Map Hypertext Markers

Works more consistently now.

Related Links to Reltables

Now scans all descendant elements of “elemname” (related-links).

Retag Paras fixes

Added support for “groups.”

Merge Code Lines fixes

Now handles code lines that start with an inline element.

Delete Empty Elems fixes

Now deletes empty elements in tables.

Write XML Topics fixes

Updated support for shredding of glossentry topics, and any “non-title” topics.