2.0.04 - 13 September 2015

Important: The FM 13.0.1 update changed the default XSLT processor from XALAN to SAXON which causes the DITA-FMx Book application’s XSLT script to fail. More information and the fix for this is described in the topic, Special Instructions for FM12 and Earlier.

New features

Added support for FM 2015

DITA-FMx now supports FrameMaker 2015.

New PDF Doc Info book-build command

Added PdfDocInfo feature to the book-build INI file (ini-only). Specify the PDF metadata values to add into the generated book. Added new PdfDocInfo section to the default book-build INI file.

Refer to PdfDocInfo Section in the “Book-Build INI file” topic for usage details.

New Show Status command and book-build option

Added Show Status command (Utilities > Show @status) to apply special status-oriented conditions to the current document. The default conditions will render content marked with @status=’new’ or @status=’changed’ with change bars. You can customize the template to apply custom formatting for all @status states.

Added ShowStatus BookBuildOverrides param (ini-only). Set this parameter to “1” to run the Show Status command on all files in the generated book. Useful for creating deliverables to be used for review purposes.

New variable building block

Added <$VAR(name)> building block variable.

Structure application updates

Abbreviate domain Elements EDD (abbreviatedomain.edd)

Modified the character tag associated with the following elements: abbreviated-form

Programming domain Elements EDD (programmingdomain.edd)

Added an associated character tag for the following elements: apiname

Software domain Elements EDD (softwaredomain.edd)

Added an associated character tag for the following elements: cmdname, msgnum

UI domain Elements EDD (uidomain.edd)

Modified the character tag associated with the following elements: shortcut, wintitle

Common Elements EDD (commonElements.edd.fm)

Added support for figure title levels (just an example) for BreakToInline on fig title before image (title element definition, firstParaRules context rule).

Modified or added the character tag associated with the following elements: boolean, keyword, state, term, tm

Topic DTD (fmx-ditabase_1.2.dtd)

Added definition for &nbsp; entity (apparently to be deprecated in DITA 2.0).

Topic EDD (topic_1.2.edd.fm)

Replaced “Red” color in “Unsupported” format rule with “DITA_Unsupported”.

Reimport updated shared EDDs.

Topic template (topic_1.2.template.fm)

Added conditions to support ShowStatus feature (DITA-StatusNew, DITA-StatusChanged, DITA-StatusUnchanged, DITA-StatusDeleted)

Added/updated the following character tags: term.abbrev, prog.api.name, boolean, soft.cmd.name, keyword, soft.msgnum, state, ui.shortcut, term, tm, ui.wintitle.

Imported updated EDD.

Map DTD (fmx-map_1.2.dtd)

Added definition for &nbsp; entity (apparently to be deprecated in DITA 2.0).

Map EDD (map_1.2.edd.fm)

Replaced “Red” color in “Unsupported” format rule with “DITA_Unsupported”.

Added choice values for permissions/@view attribute.

Map template (map_1.2.template.fm)

Added “DITA_Unsupported” color.

Imported updated EDD.

Book DTD (fmx-book_1.2.dtd)

Added fm-ditabook attributes (metadata mappings) for pubinfo-org, pubinfo-completedyear, pubinfo-completedmonth, pubinfo-completedday, permissions-view, and category.

Added definition for &nbsp; entity (apparently to be deprecated in DITA 2.0).

Book EDD (book_1.2.edd.fm)

Added fm-ditabook attributes (metadata mappings) for pubinfo-org, pubinfo-completedyear, pubinfo-completedmonth, pubinfo-completedday, permissions-view, and category.

Replaced “Red” color in “Unsupported” format rule with “DITA_Unsupported”.

Reimport updated shared EDDs.

Book template (book_1.2.template.fm)

Added conditions to support ShowStatus feature (DITA-StatusNew, DITA-StatusChanged, DITA-StatusUnchanged, DITA-StatusDeleted)

Added/updated the following character tags: term.abbrev, prog.api.name, boolean, soft.cmd.name, keyword, soft.msgnum, state, ui.shortcut, term, tm, ui.wintitle.

Imported updated EDD.

Book XSLT (bookmap2fmbook.xsl)

Added metadata mappings for pubinfo-org, pubinfo-completedyear, pubinfo-completedmonth, pubinfo-completedday, permissions-view, and category. XML mappings are as follows:

//publisherinformation/organization -> pubinfo-org 
//publisherinformation/published/completed/year -> pubinfo-completedyear 
//publisherinformation/published/completed/month -> pubinfo-completedmonth 
//publisherinformation/published/completed/day -> pubinfo-completedday 
//permissions/@view -> permissions-view 
//category -> category

Added support for author-defined conditions. Conditions created in the topic XML files can be set up to persist in the generated FM files. Add othermeta element(s) to the map where @name=’author-condition’ and @content=’CONDITION-NAME’. By default these conditions are created with the color Black, but if you want specific styling, add the conditions to the template or component template.

Changed the variable named ‘node’ to ‘nodename’.

Deleted unused ‘fmtext’ variable definition.

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

Rebuilt all component templates from the updated Book template.

Imported new variables and conditions into generated list templates.

New Book stub file for FM 2015 (structapps-stub_book_1.2_13.0.1.fm)

With the 13.0.1 update, the default XSLT processor is now SAXON. The XSLT import script in the Book app requires XALAN, so this new stub file includes the new Processor node to set the XSLT processor to XALAN.

For new installations, this stub file will be used by default, but for upgrades, it won’t, and the Generate Book from Map command will likely fail. For details, see Special Instructions for FM12 and Earlier.

Bug fixes / minor updates

FrameMaker XML Author alerts

Added alerts that display when running DITA-FMx under FM XML Author. Instead of generating errors when using commands that don’t work under XML Author, you’ll now see messages.

book-build INI updates

Added the General/AttrAsCondDefaultState parameter to the default book-build INI file.

ditafm.ini update modification

Modified the test for determining when to update the ditafm.ini file (yes, the default FM ditafm.ini not ditafmx.ini) on FM10 and later. This fixes an edge case problem that results in the inability to open topic files after installation.

http-based hrefs are not “normalized”

URLs in an external xref are no longer “normalized,” which caused errors.

fm-var and fm-data-marker updates

Fixed bug with fm-var and fm-data-marker creation for FM12. These elements moved to the start of the container paragraph, but now stay where created.

An fm-var within the source of a conref, no longer causes the conref to get wrapped in an fm-var element.

fm-var elements recreated from text in a file are no longer truncated when that text wraps in the XML.

When hiding area/data/data-about, markers (fm-data-marker elements) are no longer hidden.

data to fm-data-marker and fm-var processing

Fixed data to fm-data-marker and fm-var processing so the 'topic/data' class isn’t passed on to the new element, allowing it to take on the default class of the EDD (fmx/fm-data-marker or fmx/fm-var).

Long ids with long path no longer crash FM

Fixed crasher with very long ID values caused the path to exceed an internal limit.

Empty indexterms no longer crash FM

Empty indexterms will now properly round-trip from XML to FM and back.

Relative paths in book-build INI

Relative paths are now valid in the book-build INI for Pre/Post-BuildScript.

Ditaval filtering of reltables

Fixed ditaval filtering of reltables. Now handles attributes with multiple values; also properly checks for include vs. exclude, so include wins.

External xref updates

Fixed external xrefs so the link text sticks (doesn't revert to match the @href).

Fixed external xrefs so they don't grow characters (when "Element Banner Text" is enabled).

When creating Hypertext markers for external xrefs, if target is PDF, make into proper syntax (openlink) unless it’s a URL

imagemap fixes

Fixed problems with inserting imagemaps, shape, coords, xref didn't render values properly.

book-build updates

Disable “Element Banner Text” display when running a book-build (FM11 and later).

BreakToInline figure handling

Updated BreakToInline processing so it works for figs where the title isn’t moved.

IndentTables handling

Updated IndentTables processing so when checking parent element’s text object, if the parent and the table anchor’s object don’t have the same FP_Placement (Format: “In Column”, “Run In Head...”, etc.), the table is left unindented.

Keyspace Manager update

Fix to INI-reading code which truncated keyspaces listed in Keyspace Manager.

fm-xref updates

fm-xrefs referencing another file now properly add the value for @type attribute (target element name).

Fixed fm-xrefs so you can click to edit existing fm-xrefs.

Stopword handling

When removing stopwords, if the result of processing leaves an empty string, set it to the first “word” in the string.

Element template support

Updated new file from element template so any existing IDs in the element template are updated (if Auto-Add IDs is enabled).

New file command update

When creating a new file of the same name that exists, it will now successfully delete the existing file (after prompting for approval).