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
- None.
- 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 structapps.fm file the name would be
truncated in the Options dialog.
0.01 - 20 August 2007
Initial Beta release.