2.0.03 - 31 March 2015

New features

Added support for ditaval filtering by deletion

This feature more closely emulates the ditaval filtering done by the DITA-OT. Instead of content being hidden by FrameMaker’s conditional text feature, the content is deleted from the generated FM files. Additionally, if the root element of a generated file is to be excluded, that FM file is deleted from the book.

To support this feature, new INI parameters have been added. In the ditafmx.ini file you’ll see BookBuild/DitavalFilterType and in the book-build INI you can now use BookBuildOverrides/DitavalFilterType. The values for both of these can be 0 (no filtering), 1 (filter by conditions), or 2 (filter by deletion).

Another new ditafmx.ini parameter is INIOnly/FilteringAttributes. This specifies the attributes that are considered when performing ditaval filtering. The default value is a space-delimited string of attribute names “audience product platform otherprops rev props”.

The Apply Ditaval As Conditions command has been renamed to Utilities > Apply Ditaval and now offers both filtering with conditions and filtering by deletion options.

Added support for ditaval filtering of reltables

Ditaval filtering during the book-build process will now affect related links added from relationship tables, based on filtering attributes applied to relrow and topicref elements.

Book-build enhancements

The generated book file is now saved automatically at the end of a book-build.

The following options have been added to the book-build INI:

  • BookBuildOverrides/MoveFigTitles - Move fig/title after image (2) or to the end of the fig (1).

  • BookBuildOverrides/DitavalFilterType - (described above)

  • DitavalDefaultsOverrides section - replicates values from the DitavalDefaults section in the ditafmx.ini file. If used in book-build INI file, overrides those settings for the current book build. Only applies to ditaval filtering that uses the filter by conditions option.

New command: Insert Topicrefs

The Insert Topicrefs command lets you insert multiple topicrefs at one time. This is only available on FM10 and later.

Enhanced support for Japanese indexes

The sort-as element now works properly for Japanese indexes.

Added new parameter to the ditafmx.ini file to support the Japanese index marker name. On Japanese systems the Index marker is not named “Index.” Set the IndexOptions/IndexMarkerType parameter to the correct name.

Added new option “Conditionalize required-cleanup”

This option is similar to the other “conditionalize” options, and allows the automatic conditionalizing of any required-cleanup elements. It applies a DITA-Cleanup condition to the required-cleanup elements.

Added new API command: MAPTOWORKBOOK

If you’re performing automation with DITA-FMx, the new MAPTOWORKBOOK command will allow you to generate a “work book” from a map. This API is only available if FMx-Auto is enabled.

Added support for the AZARDI EPUB reader

[Experimental] If you want to use an EPUB for online Help in DITA-FMx, you can do that with the AZARDI reader. To enable this, add the following entry to the ditafmx.ini file: ExternalApplications/EPUBReaderAppExe=<path-to-exe>

Structure application updates

Map DTD (fmx-map_1.2.dtd)

Updated to add proper general rule for indexterms in maps.

Topic EDD (topic_1.2.edd.fm)

Updated synph element context rules to check for special values for outputclass attribute. If outputclass is set to “element”, the synph content is wrapped in angle brackets, and if set to “attribute” an “@” prefix is added.

Topic template (topic_1.2.template.fm)

Added DITA-Cleanup condition.

Imported updated EDD.

Topic rules (topic_1.2.rules.txt)

Added ‘row’ and ‘entry’ rules.

Book XSLT (bookmap2fmbook.xsl)

Added new metadata to fmx-variable mappings for: bookpartno, booknumber, maintainer/person, and maintainer/organization.

Book EDD (book_1.2.edd.fm)

Added new fm-ditabook attributes for metadata to fmx-variable mappings: bookpartno, booknumber, maintainer/person, and maintainer/organization.

Added support for fm-figuredesc (element definition and modified fig general rule).

Updated synph element context rules to check for special values for outputclass attribute. If outputclass is set to “element”, the synph content is wrapped in angle brackets, and if set to “attribute” an “@” prefix is added.

Book DTD (fmx-book_1.2.dtd)

Added new fm-ditabook attributes for metadata to fmx-variable mappings: bookpartno, booknumber, maintainer/person, and maintainer/organization.

Book template (book_1.2.template.fm)

Added DITA-Cleanup condition.

Imported updated EDD.

Normalized the main Book template with the “gentpl” component templates to ensure that all para tags exist in all templates. This makes the “Save As PDF” from a generated book work better so the para tags are listed properly by default.

Book rules (book_1.2.rules.txt)

Added ‘row’ and ‘entry’ rules.

Book component templates (tpl~*.fm and gentpl~*.fm)

Rebuilt all component templates from the updated Book template.

Bug fixes / minor updates

Book-build conditional tagging cleanup

Removed the process that added the DITA-Topicmeta conditon to generated chapter files. Also made sure that all setting of conditions in generated chapter files was also applied to the generated list files. This seems to eliminate the book-build errors reported about inconsistent conditions.

Generate Workbook from Map updates

The Generate Workbook from Map command has been updated to significantly decrease the time required to generate the book. For maps with many (100+) topics, this previously took 20 minutes or more. Now it might take a minute for 500 topics.

Auto-add @id updates

The auto-add @id process now works when wrapping with an element that requires an @id attribute.

Fix Linebreaks option deprecated on FM12

The Fix Linebreaks option is no longer needed on FM12 (in fact it was causing problems), so it is not available on that version of FM.

Linebreak PIs within preformatted elements

Linebreak PIs are no longer added within preformatted elements.

Cleanup on coderef handling

Edge cases of multiple coderef elements in a codeblock, now work better.

Properly reads nested key maps

It’s often useful to create nested key maps, and now DITA-FMx will properly interpret the key definitions in those maps.