Revision History

Describes the changes between versions of DITA-FMx.

1.0 (1.00.26 update)- 31 August 2008

New Features
Search in Files command matches on partial attribute values.
The Search in Files command now allows for matching on partial attribute values. This is especially useful for locating elements that have multiple values applied to their filtering attributes.
Structure Application Updates
Bug Fixes
Apply Ditaval as Conditions command applies overlapping conditions.
The Apply Ditaval as Conditions command now applies overlapping conditions as required by attribute settings.
Generate Book from Map no longer saves XML files as FM.
In rare circumstances the Generate Book from Map command would save the XML file as a binary FM file making it impossible to continue. This no longer happens.
WMF images are now properly handled.
When adding a WMF image, it was not properly shrinkwrapped and the href value was not set until file save. WMF files are now handled the same as other image types
Windows Vista problems fixed.
On Windows Vista, inserting an xref no longer causes FM to crash.
Element templates must be closed to be used.
If you try to use an element template for a new file when the element template is open, you now receive a warning that you must close the template before it can be used.
Build Map from Outline handles invalid para styles.
If a paragraph style in the outline document references a style that doesn’t map to a topic type FM will no longer crash.
Conref problems resolved.
A conref to an xref will no longer cause FM to hang. Conrefs can now be made to simpletable elements (and related table types).

1.0 - 7 July 2008

New Features
FrameMaker 8 support.
Now supports FrameMaker 8 and all of its Unicode functionality.
Full support for link elements.
Link elements in the related-link section of a topic are now managed the same way xref elements have been.
Search in Files command.
Provides the ability to search for content in files within a folder (and sub-folders) or in files referenced by a DITA map. The search criteria can be a mix of textual content, element or attribute names, or attribute value.
Where Used command.
Generates a report listing all files that reference the selected element or current topic.
Set Attributes command.
Provides quick and easy access to setting attributes on elements. In particular, this command makes use of the FrameMaker “Strings” attribute type and allows you to select one or more default values that are applied to the attribute.
Updated New DITA File command.
The New DITA File dialog now lets you enter the topic or map title and automatically generate a proposed file name based on your specification (in the New File Options dialog). You can also optionally select an element template to insert predefined structure and content to the new file. If needed, you can specify a folder name along with the file name and that folder will be created if needed.
Integrated ditaval support and management.
The Ditaval Manager provides an easy to use interface for creating and managing ditaval files. These files can be used to apply conditional filtering to FrameMaker books and documents as well as passed to the Open Toolkit for filtering of the generated content.
Handles “pretty-printed” XML files.
A new option strips padding (spaces and tabs) from files on import.
Auto-Prolog feature.
A new option lets you specify certain prolog data to automatically add or update on file creation and file save.
Build Map from Outline command.
Creates a DITA map and optionally DITA topic files from a simple FrameMaker document.
Build ‘WorkBook’ from Map command.
Generates FrameMaker book file that contains all of the DITA files referenced by a DITA map and any sub-maps. This command facilitates the use of FrameMaker’s commands that iterate over files in a book (such as spell checking and search).
Open All XML Files in Book command.
Intended to be used with the “WorkBook,” this command opens all of the XML files in a book and provides the option to resolve references or not in the opened files.
Topicref labels in DITA maps.
A new option allows you to choose the type of content displayed in the topicref label. You can see the title, the file name or both.
New DITA File updates.
The New DITA File command is now available from the File menu in addition to the DITA-FMx menu. When creating a new DITA file, you can now overwrite an existing file, and create new folders.
ID attribute validation.
When manually changing an ID attribute value, a warning is displayed if it is invalid.
Added Xref to Hyperlink command.
This command converts DITA-based xrefs and links into FrameMaker Hyperlinks that are live hyperlinks in generated PDF files.
Variables persist through the Map to Book process.
Two new commands have been added, Prepare Variables and Rebuild Variables, which make it possible for FrameMaker variables that are used in DITA files to be available as live variables in the generated book files.
Reference Manager “remembers” last selected element type.
When you use the Reference Manager, it now defaults to selecting the last referenced element type.
Added option to disable coloring of conrefs.
If the coloring of conrefs causes problems for your output tools (WebWorks in particular doesn’t like it), you can now disable this in the Topic or Book applications.
Now recognizes the “include” ditaval action.
The Ditaval Manager and the Apply Ditaval as Conditions command now recognize the “include” ditaval action value.
Added Check for Updates command.
The Check for Updates command was added to the menu as well as a setting in the Options dialog to specify the frequency to automatically check for updates.
Added “break conref” functionality.
If you need to convert a conref into editable text (and sever the connection to the source element), delete the conref attribute value and double-click the conref.
Added special image-handling features.
The “fmdpi” feature maintains alternate image sizes within FrameMaker. Add the value, “fmdpi:<DPI>” to the image/@otherprops attribute (where <DPI> is the DPI value). See the Working with Images topic for more info.
The default alignment for new images is now defined by the default value of the image/@align attribute.
Added API calls.
FMxVer, FixBookRefs, and LoadReferences.
Added the fm-* elements to the DITA Reference.
Now when you use Alt+F1 to get help on the selected element, it will work for the “fm-*” elements as well.
Structure Application Updates
Changed “String” to “Strings” type for filtering attributes.
To allow easy use of the new filtering groups feature of the Set Attributes command, the attribute type for platform, product, audience, and otherprops has been changed to “Strings” in the Topic and Map applications.
Added a user-settable method of round tripping graphics as non-cropped.
A “don't crop” read/write rule has been added to the topic and book rules files. By default it is commented out, but by enabling it, graphics can round-trip without FrameMaker resetting them to "Cropped" during import.
Added formatting support for more elements within a fig.
Some formatting support for lists (ul and ol), p, dl, and note has been added and now includes formatting for contexts where fig has its attribute expanse set to page. Also, a list whose compact attribute is set to “yes” within a fig will now format as a horizontal list.
Line below Task is more reliably drawn.
The line indicating the completion of a Task now occurs in more contexts.
Corrected format of Topic label text in reltable heading.
The “Topic,” “Reference,” “Concept,” and “Task” text that automatically appears in the column heading of a reltable is now properly left-aligned in its cell.
Topicmeta formats for author and keyword are now more consistent.
Author element text now properly aligns with the other elements in topicmeta. And, keyword elements receive more consistent formatting where multiple keywords occur.
Book template DITA-Comment and DITA-Prolog conditions display default is now properly set.
With the DITA option set to conditionalize Prolog or Comment elements, when a DITA file is opened that contains comment or prolog elements, the template default is now to Hide those elements. (For Topic and Map templates, the default behavior is still to Show those conditions.)
Bug Fixes
Processing Instructions after the document close tag.
Opening an XML file that has a PI (processing instruction) after the document's closing tag no longer crashes FM when you save that file.
Proper handling of colons in the forced sort area of an index entry.
Colons in the forced sort area of an index entry (within square brackets) are no longer treated as level separators when saving to XML. The forced sort content is written to the last indexterm element.
fm-xref and fm-link element fixes.
Fixed problem where fm-xref and fm-link elements did not properly reference sub-topic elements.
New file command properly creates topics with specialized title elements.
If your specialized topic type uses a “title” element with a name other than “title” it properly uses that specialized element.
Clipboard content is not lost when opening a new topicref.
If you copy something to the clipboard, then open a topic by clicking a topicref, that content is still available for pasting.
Conrefs that specify no file name now resolve to the current file.
When the conref attribute specifies no file name (as in conref="#topicid/elemid") the conref looks for “topicid/elemid” in the current file.
Topicrefs that reference a topicid now process correctly.
Updated the book processing XSLT file so it can handle topicrefs that reference a file and a topicid (topicref/@href='filename.xml#topicid').
On file open, a missing image now triggers the “missing image” dialog.
When opening a file, if an image can’t be found, the default “Select image file” dialog is now displayed.
Replacing an existing image properly updates the href attribute.
If an existing image is replaced through the FrameMaker interface, when the file is reopened the new file name is still properly specified.
Column widths in simpletable and choicetable elements.
These elements now round trip properly.
Tables in generated files are full width.
When building a book, tables now fill the width of the text column.
Moved INI parameters around a bit.
The following INI parameters have been moved from one section to another (as indicated):
General -> INIOnly/AutoLoadTopicrefs
General -> INIOnly/XrefElements
General -> INIOnly/StructappsFile
General -> INIOnly/FmXrefElem
General -> INIOnly/FileOpenClient
General -> INIOnly/DitaHelpKeys
General -> INIOnly/DitaReference
General -> DitavalDefaults/DitavalName
General -> DitavalDefaults/DitavalExcludeConditionName
General -> DitavalDefaults/DitavalExcludeConditionNameType
General -> DitavalDefaults/DitavalExcludeConditionVisibility
General -> DitavalDefaults/DitavalFlagConditionName
General -> DitavalDefaults/DitavalFlagConditionNameType
General -> DitavalDefaults/DitavalFlagConditionVisibility
GeneralImport -> General/CheckForComments
Other misc. fixes.
Various cleanup and bug fixes.

0.02 - 18 December 2007

New Features
Book-building component is now included.
The ability to generate a FrameMaker book from a DITA map is now included with DITA-FMx.
Added ditaval filtering for authoring and output.
The Apply Ditaval as Conditions command lets you apply ditaval filtering to the document being authored, and the Use Selected Ditaval File option in the Generate Output dialog lets you specify a ditaval file for use with a DITA-OT target.
New “Auto Smart-Spaces” option makes it easier to work with code in documents.
If enabled, this option automatically disables and enables the FrameMaker “Smart Spaces” option when the insertion point is moved into and out of a preformatted text element (one based on the “topic/pre” class).
Child elements and line breaks can coexist in preformatted elements.
The new option, “Fix line breaks in topic/pre elements,” properly allows for child elements within preformatted ("topic/pre") elements. If this option is enabled, line breaks are no longer lost when a child element is before or after a line break. (This overcomes the native FrameMaker bug/feature.)
The character sequence “]]>” can be used in FrameMaker.
Typically, you can’t include the characters “]]>” within a FrameMaker document saved to XML. DITA-FMx now overcomes this standard limitation.
Specify the number of reference levels to resolve.
When you open a DITA file (and the auto-loading reference options are enabled), DITA-FMx resolves all conrefs and xrefs in all referenced files. This new option allows you to specify the number of reference levels to resolve (typically 2 is plenty). For documentation sets that make extensive use of references, this can significantly speed up the time it takes to open topic files.
Pressing ESC while files are resolving will interrupt the process.
If you need to abort the file resolving process, press ESC.
The Reference Manager dialog now defaults to the last referenced file.
Instead of defaulting to the current file, the Reference Manager now defaults to the most recently referenced file.
External Xref dialog now provides External or Peer options for the scope attribute.
The scope attribute of external xrefs were previously assigned the value of “external,” this value can now be set to either “external” or “peer.”
When xrefs are created they are now populated with the proper type, format, and scope attributes.
Xref elements created and modified through the Reference Manager are now assigned the proper type, format, and scope attributes.
Set up environment variables before running the Ant script.
The EnvironmentSetup INI-only parameter lets you specify a batch file to run before the Ant script in order to properly set up the environment for an OT build.
Updated support for topicmeta element in a map.
The EDD and template have been updated to provide a nicer rendering of topicmeta data. Also, a new option was added to the Options dialog to allow conditionalizing of topicmeta on file open.
TOC and Index templates provided for easy book-building.
Two template files are now provided with the Book application making it easy to set up a complete book.
Structure Application Updates
Topic Application.
<note> - Formatting changes to correct some indention issues.
<ol>, <ul>, <sl>, <li>, and <sli> - Formatting changes to correct indention and “red text” issues.
<xref> - Character format added for context scope= "external" (link.external).
<apiname> - Now formats as a text range.
Book Application.
Same updates as those for the Topic application.
<fm-ditabook> - Added <fm-subditamap>.
<title> - Modified formatting of <title> to provide support for maps of maps. Modified syntax- and group-related context labels so that they'd not be picked up in TOC generation that went to Level4.
Map Application.
Corrected copyright and legal info.
<topicmeta> - Added formatting for all <topicmeta> elements when option is invoked. Added DITA-Topicmeta condition to template.
Bug Fixes
Conrefs resolve properly.
All known problems with conrefs have been fixed, including conrefs to tables and conrefs to single block elements.
Xrefs that wrap over a line are no longer truncated on save.
Xrefs at the end of a paragraph now save properly.
Indexterms in book builds aren't duplicated.
Nested indexterms in a book build resulted in the duplication of all but the top level entry, this no longer happens.
Indexterm elements are no longer saved with the hard-coded class value.
This made it impossible to specialize the indexterm element.
DITA-Comment and DITA-Prolog conditions are no longer saved as PIs.
Because conditions are saved as Processing Instructions, the DITA-Comment and DITA-Prolog conditions were saved as well. This caused a problem when the "Conditionalize element on file open" options were used, causing the condition to be set even when the options were disabled.
In the DITA Options dialog, if an application is not selected, it shows as empty.
Previously, this would default to the first application in the list.
Table format and tgroup/@outputclass value are now in sync.
Changing one updates the other.
The clipboard contents are now saved before creating a new DITA file.
Previously, the clipboard contents were lost when the New DITA File command was used.
The Open All Topicrefs command properly processes all topicref files.
Now all topicrefs are processed.
No longer displays warning about comments when resolving references.
This warning now only happens on file open (if the option is enabled).
Elements with general rule of “<TEXT>” now conref properly.
Any elements with the lone general rule of “<TEXT>” were saved incorrectly when conrefed. A temporary fix was to change the general rule to “(<TEXT>)*” but this fix is no longer needed.
The Reference Manager dialog now properly highlights the selected topic.
Previously when double-clicking an existing xref, the current file was not selected.
Long application names now display properly in the Options dialog.
Previously, if an application name was so long that it wrapped in the file the name would be truncated in the Options dialog.

0.01 - 20 August 2007

Initial Beta release.