Describes the changes between versions of DITA-FMx.
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.