Omni Systems, Inc. Mif2Go User's Guide, Version 55
> About this guide > New information
The Mif2Go User's Guide is a perpetual work-in-progress, largely unreviewed.This section identifies substantive additions and corrections since prior editions. Corrections are shown in red.
May 15, 2013 version 4.1, update 55
m2rbook.dll
and m2gframe.dll
to the correct Plugins
directory. These files are located in %OMSYSHOME%\m2g\plugin
in your distribution, and they must be copied to your FrameMaker \fminit\Plugins
directory; see §1.3.3.2 Finish installing Mif2Go.
Converting a book or document:
[Automation]CopyAfterFrom
is relative to the project directory (correction). Not to the wrap directory; see §4.5 Specifying file paths in configuration settings.
[Setup]TemplateFileName
is relative to the location of the configuration file
in which the setting occurs (correction). Not to the source directory; see §4.5 Specifying file paths in configuration settings.
Setting basic conversion options:
[Setup]FileSuffix
for all output types; see §5.1.1 Checking output type and file extension.
Though still recognized, the following are deprecated in favor of [Setup]FileSuffix
,
which overrides them in any event:
ShowUndefinedFormats
,
on by default; see §5.2 Logging conversion events.
IDAttrName
and IDRefAttrName
, new section [AttributeMarkers]
;
see §5.8 Converting structured documents.
FrameEndPara
;
see §6.10.9 Omitting content from RTF output.
Generating Microsoft HTML Help:
BinaryTOC
and BinaryIndex
; see §9.9.2 Choosing whether to generate binary contents or index.
MakeCshMapFile
,
CshMapFileNumStart
, and CshMapFileNumIncrement
;
see §9.12.3 Specifying and generating a map file for CSH links.
CompoundWordChars
;
see §10.10.3 Making compound terms searchable.
[ConditionOptions]
;
new settings UseConditionalFlagging
,
CSSFlagsFile
, WriteFlagsFile
,
and ReferenceFlagsFile
. See §13.10.3 Displaying condition indicators in HTML with CSS.
<pre>
elements from merging. New setting MergePre
;
see §13.6.5 Preventing adjacent <pre> elements from merging.
<fig>
as an exception. Newly documented HTML format
property Figure
; see §15.7.2 Specifying what to include in a <fig> wrapper.
UseTopicAlias
; see §15.14 Including CSH targets in DITA XML.
id
attribute from chapter maps. New setting
UseMapID
; see §16.2.1.6 Specifying the ID for a ditamap.
No
, MakeFileHrefsLower
is set to Yes
in system file d2htm_config.ini
,
which is referenced for every HTML output type. If you want Mif2Go to leave case alone in hypertext links, you
must explicitly set MakeFileHrefsLower
to No
in a project or local configuration file; see §19.2.6 Forcing link text to lowercase.
Mapping text formats to HTML/XML:
[ParaTags]
and [CharTags]
replace [ParaStyles]
and [CharStyles]
, respectively; see:
§21.3.1 Assigning HTML tags and attributes to paragraph formats
§21.4 Mapping character formats
[HTMLParaStyles]
and [HTMLCharStyles]
supersede [HTMLStyles]
,
which is still honored; see §21.5 Assigning properties to text formats.
UseFontSize
;
see §21.7.6 Excluding face and size attributes from font tags.
SelectorIncludesTag
;
see §22.7.10 Omitting tags from CSS selectors.
HeadFootBodyTags
;
see §24.3.2.4 Wrapping table row groups.
The old sections are deprecated, but still honored; see §28.9.3 Surrounding or replacing text with code or macros.
Working with FrameMaker markers:
[MarkerTypeCodeReplace]
; see §29.7.2 Surrounding marker content with code.
runfm
. New command-line
option -pdfsave
can avoid printer
issues and TimeSavers issues; see §36.4.3.3 Configuring PDF output: runfm -pdfsave option.
May 1, 2012, version 4.0, update 54
Planning a conversion project:
HistoryFileName
;
see §5.2 Logging conversion events.
EqSuffix
;
see §5.9.4 Providing a file-name suffix for equations.
CodePage
;
see §6.2.4 Specifying the default output language and code page.
TrailingTabs
;
see §6.8.3 Altering tab behavior for Word output.
.doc
or .docx
files via Word macro and a SystemEndCommand
.
See §6.17.1 Supporting more than one version of Word.
UseHVIndex
,
new custom marker type HVIndex;
see §7.5.2 Preparing index entries for Microsoft Help Viewer.
Compiler
; see
§8.2.13 Compiling a WinHelp project.
HelpCopyright
and HelpCopyDate
; see §8.2.13 Compiling a WinHelp project.
FootnoteSeparator
;
see §8.3.7 Converting footnotes.
TblFullWidth
; see §8.5.2 Adjusting table appearance.
Generating Microsoft HTML Help:
UseCodePage
;
see §9.3.6 Deciding whether to compile HTML Help.
Compiler
;
see §9.14.1 Directing Mif2Go to run the HTML Help compiler.
Generating JavaHelp or Oracle Help:
[OracleHelpOptions]
;
for example, see §11.3.7.2 Letting Mif2Go set up the directory structure and copy
files.
UseListTypeAttribute
;
see:
§11.3.9 Coping with JavaHelp / Oracle Help viewer limitations
§21.12.2.7 Including or excluding the type list attribute.
[HtmlOptions]GeneratorTag=None
;
see §13.4.4 Including or omitting HTML/XML generator information.
Confluence
,
ConfluenceLinks
, and ConfluenceLink*
;
see §13.12 Generating XHTML for Confluence 4.x.
GlossTitle
,
new sections [GlossTitles]
and [GlossFiles]
;
see §13.11 Providing hover text for terms in HTML.
UseSpacers
explicitly to indent tables and figures!
Important if your output relies on this setting, because the
default value has been changed to No.
See:
UseXMLbr
;
see §14.4.5 Configuring forced returns for XML.
[DITAAliases]
,
new predefined macro variable $$_ditastart
;
see §15.4.3.8 Mapping paragraph format aliases algorithmically.
UseTypographicElements=Yes
,
you get <chbar>
and <over>
elements, respectively; see §15.4.4.2 Including typographic elements in addition to mapped
formats.
SetElementIDs
;
see §15.4.6.2 Including an id attribute in every element.
[DITATopicRootAttrs]
,
new marker type DITATopicRootAttrs;
see §15.4.6.3 Specifying attribute values for the root element of a
topic.
outputclass
attribute in the DITA XML root element. New
marker type DITATopicOutputclass;
see §15.4.6.6 Providing outputclass attributes for all elements.
UseCommonNames
;
see §15.5.6 Avoiding invalid ancestries.
TableColsRelative
;
see §15.6.5.3 Specifying relative vs. absolute widths for table columns.
UseTableFooterClass
,
TableFooterClass
; see §15.6.2 Marking table footer rows for future reference.
FigureTitleStartsFigure
;
see §15.7.2 Specifying what to include in a <fig> wrapper.
[Graphics]GraphScale
;
see §15.7.3 Omitting size attributes from images for DITA output.
<alt>
text. New setting MathFullForm
;
see §15.7.5 Including MathFullForm equations in <alt> elements.
<image>
attributes. New setting UseOtherpropsDPI
;
see §15.7.6 Including the original image DPI as an attribute.
XrefWrapClass
,
FootnoteWrapClass
, and IndexWrapClass
;
see §15.10.2 Specifying an outputclass for cross-reference wrappers.
AllowPartAppendix
;
see §16.3.4 Extending <part> to include <appendix>.
MapBookRelTable
;
see §16.3.6 Excluding the book-level reltable from a bookmap.
[IndexMarkerOutputClass]
,
[DITABookmapOutputclasses]
; see
§16.4.3 Including multiple booklist components of the same type.
[BookmapElementBefore]
,
[BookmapElementAfter]
; see §16.4.7 Including placeholders for additional bookmap elements.
MultiImageFigures
;
see §17.7.1 Deciding what to include in a figure element.
CloseFigAfterImage
;
see §17.7.1 Deciding what to include in a figure element.
FigureTitleStartsFigure
;
see §17.7.1 Deciding what to include in a figure element.
[Graphics]GraphScale
;
see §17.7.3 Omitting size attributes from images for DocBook.
Splitting and extracting files:
[Inserts]
keyword TopicBreak
; see:
§18.5.2 Assigning code to [Inserts] keywords for splits and extracts
§28.9.2 Invoking macros at predetermined points in output.
XrefSpaceChar
or HyperSpaceChar
;
see §19.2.5 Replacing problem characters in links.
Mapping text formats to HTML/XML:
[HTMLParaStyles]
format property NoWrap
;
see §21.3.6 Stripping paragraph properties.
NoFonts
and NoSymbolFont
have been reversed;
see:
§21.7.4 Including or excluding font tags
§21.7.5 Managing font tags for symbol fonts
chbar
and over
;
see §21.8.2 Choosing how to treat typographic elements.
ClassSpaceChar
; see
§22.7.1 Understanding CSS class name restrictions.
UseCharRangeClasses
,
new section [CharacterRangeClasses]
;
see §22.7.6 Assigning CSS classes based on Unicode character ranges.
UseSpacers
=Yes
;
see §23.6.3 Indenting images.
alt
attribute values from HTML output. New setting
AllowEmptyAlt
; see §23.8 Providing (or omitting) alternate text for images.
UseSpacers
=Yes
;
see §24.5.1 Indenting tables.
§24.6.4 Turning processing on and off around selected tables
§24.7.2 Removing table-specific tags from selected tables.
\~
”
for trailing spaces; see §28.1.1.3 Escaping special characters in macro definitions.
$$_prjname
;
also, variable $$_prjpath
can now be used in
macros as well as in system commands. See Table 28lower
,
upper
, and replace
with
; see Table 28$$_macroparam
;
see §28.7 Passing a parameter to a macro.
Working with FrameMaker markers:
Text
;
see §29.7.3 Processing marker content as text for XML/HTML/XHTML.
[Templates]
section with new settings Document
,
Configs
, and Macros
;
see §30.1 Working with configuration templates.
[FDK]ConfigTemplate
is deprecated in favor of [Templates]Configs
.
Replace all instances of the former; see §30.2 Referencing configuration files and templates.
[Templates]Document
;
see §30.3 Including document-specific configuration files.
Automating Mif2Go conversions:
See §34.4.1 Specifying system commands.
<$$_objectid>
in file names. To guarantee uniqueness, if
you are determined to name output files yourself; see §34.8.4.5 Specifying a file-name prefix or suffix.
Producing deliverable results:
[Automation]
settings CopyBeforeFrom
, CopyBeforeFiles
,
CopyAfterFrom
, CopyAfterFiles
;
see:
§35.5 Gathering additional files before converting
§35.6.6 Listing extracurricular files to put in the wrap directory.
WrapPath
is now .\_wrap
, relative to the project directory; see §35.6.1 Specifying a wrap directory.
CopyOriginalGraphics
;
see §35.7.1 Copying referenced graphics to a distribution directory.
ShipPath
is now ..\..\_ship
, relative to the project directory; see §35.12.1 Specifying a shipping directory for deliverables.
runfm
.
Because you must write to the Windows Registry; see §36.2 Setting up FrameMaker for unattended operation.