F HTML/XML configuration
This section provides an annotated list of all the configuration sections, keywords, and values for settings you can specify in configuration file mif2htm.ini, for HTML or XML output from Mif2Go.
§4 Setting configuration options.
; mif2htm.ini contains initial info for the DCL MIF to HTML filter
; this is m2htm.txt for dwhtm.dll version h284 and m2rbook.dll b108
; Output = Standard (default, HTML), MSHHelp (HTML Help), JavaHelp (Sun),
; Cross-platform OmniHelp, EclipseHelp, OracleHelp (extended JavaHelp),
; DITA, XHTML, GenXML (generic XML), Book (DocBook XML), or AsciiDCL.
; The next three items control how names are matched to ini-file settings
; CaselessMatch = Yes (default, ignore uppper/lower differences) or No
; SpacelessMatch = Yes (default, ignore embedded spaces) or No
; WildcardMatch = Yes (default, allow ? and * in settings) or No
; These two are used for diagnosis of possible memory-management problems.
; Try changing them to "Yes", one at a time, if you get a crash at the very
; end of processing, after the output files have been writtten correctly.
; moved to [HTMLOptions] but still valid here
; HideWhiteText removes any white text (standard FrameMaker behavior)
; RemoveEmptyParagraphs = No (default) or Yes (remove paras with no text)
;EmptyParaContent = string to put in otherwise-empty paragraphs
; moved to [Graphics] but still valid here
; UseGraphicPreviews = No (default) or Yes (use preview bitmaps for frames)
; UseInitDialog = Yes (default, to display dialog before conversion) or No
; UseDoneDialog = Yes (default, to display dialog after conversion) or No
; UseExistingMIF = No (default, save new .mif file) or Yes (use if it exists)
; UseFrame8MIF = Yes (default, for Frame 8 only), or No (to get Frame 7 MIF)
; DeleteMIF = No (default, keep MIF file when HTML is done) or Yes (delete it)
; UseExistingDCL = No (default, make .dcb) or Yes (use .dcl file if it exists)
; Suffixes to use for each output type
; ConfigTemplate = path to .ini file to be used when mif2htm.ini and any
; specific filename.ini do not contain the setting being checked. The
; referenced file can also contain [FDK]ConfigTemplate, so the chain of
; templates searched can be any length. However, all files in the chain
; must have distinct names; the chain stops if it finds a repeat.
ConfigTemplate=D:/path/to/template.ini
; PrjFileName = name of project file that references this directory
;PrjFileName=D:/path/to/yourbook.prj
; IDFileName = name of file that contains File IDs for this project
;IDFileName=D:/path/to/mif2go.ini
; UseLocalFileID = No (default, use IDFile IDs) or Yes (use [FileIDs] here)
; WriteEquations = No (default) or Yes (write equations as graphics files)
; WriteAllGraphics = No (default) or Yes (write all anchored frames as files)
; WriteRefPageGraphics = Yes (default) or No (exclude reference frames)
; WriteMasterPageGraphics = No (default) or Yes (include header/footer graphics)
; UseGraphicFileID = Yes (default) or No (single-file projects only)
; GraphicNameDigits = 6 (default), or 4 to 8 (for longer or shorter names)
; GraphicsFirst = No (default, write only needed graphics after DCL process),
; or Yes (old way, write graphics of the types specified before DCL process)
; EquationExportDPI = number (from 50 to 1200, default 120)
; EquationFrameExpand = percentage of original size (default 125)
; GraphicExportDPI = number (from 50 to 1200, default 96)
; GraphicExportFormat = BMP, TIFF, WMF, JPEG (default), GIF, PNG, EPS,
; ApplyTemplateFile = No (default) or Yes (save and restore around it)
; TemplateFileName = filename.fm (FrameMaker template for export)
; AppliedTemplateFlags = 0 (default) or bitfield spec of properties
; 0=all + 1=PgfFmt + 2=CharFmt + 4=PageLayout + 8=TblFmt + 16=CondText +
; 32=RefPage + 64=VarDef + 128=CrossRef + 256=ColorDef + 512=MathDefs +
; 1024=DocProps + 16384=RemoveManPageBreaks + 32768=RemoveOverrides
; ImportDocProps = Yes (default) or No (exclude doc props from import)
; SetFrameConditions = No (default) or Yes (set per [ConditionsShown]
; after template import, if any).
; ConvertVariables = No (default) or Yes (convert to plain text)
; GenerateBook = No (default) or Yes (generate after import)
; UseFrameTOC = Yes (default, except for Help formats and DITA), or
; No (default for Help formats and DITA)
; UseFrameIX = Yes (default, except for Help formats and DITA), or
; No (default for Help formats and DITA)
; UseFrameGenFiles = Yes (default for all formats except DITA), or
; PluginVersion = version identifier for m2rbook.dll last used, written
; by plugin at the start of each run. Check it against the version of
; m2rbookNN.zip in the downloads dir on the Web site to make sure you are
; using the most current version.
; CheckLinks = No (default) or Yes (check links after running a book)
; CheckLinkLog = D:\path\to\LinkLog.fm to make copy of Book Error Log
; containing links to errors that does not disappear when Frame closes.
; LinkLogAlways = Yes (default) or No (do not display Book Error Log if
; CompileHelp = No (default, run compiler separately), or Yes (MS HH only,
; copy all needed files to the WrapPath, if given, then compile with hhc)
; KeepCompileWindow = No (default) or Yes (so any MS HTML Help error
; WrapAndShip = No (default) or Yes (use WrapPath, ArchiveCommand, ShipPath,
; and Copy/Empty settings as described below)
; WrapPath = path to dir to contain the files to be wrapped for distribution;
; when ArchiveCommand or CompileHelp are specified, dir where that is done,
; after which the result (.chm, .hlp, .jar, or .zip) is copied to ShipPath.
; The files copied are specified in WrapCopyFiles, with defaults given below:
; For MSHH, files copied are *.htm, *.js, *.hh?, and *.h, then the
; For JH, and OHJ, files copied to the top level are *.xml, *.hs, *.jhm,
; to ./html are *.htm and *.js, and to ./graphics are *.gif, *.jpg,
; and *.png. After copying, the indexer is run if named in FTSCommand.
; For OmniHelp, files copied are *.htm and *.oh?.
; If OHViewPath is set, also copies oh*.* from there to WrapPath.
; For DITA, files copied are *.dita, *.ditamap, *.bookmap, *.dtd, *.mod,
; For other HTML and XML formats, files copied are *.htm, *.html, *.xml,
; *.js, *.txt, *.dtd, *.mod, *.ent, and *.xsd.
; For all formats, the GraphCopyFiles (default *.gif, *.jpg, *.png, and *.svg)
; are copied to GraphPath (relative to WrapPath) as well; for JH and OHJ,
; they go to the [JavaHelpOptions]GraphSubdir. If CopyGraphicsFrom is set,
; any GraphCopyFiles are also copied from there to GraphPath (or to the
; Similarly, the CssCopyFiles (default .css and .xsl) are copied to [CSS]
; CssPath (relative to WrapPath); for JH and OHJ, the CssPath is relative
; to [JavaHelpOptions]HTMLSubdir. If CopyCssFrom is set, any CssCopyFiles
; are also copied from there to CSSPath.
; WrapCopyFiles = list of files to copy, separated by spaces, wildcards
; and paths (relative and absolute) allowed, no spaces within an item,
; overrides the defaults shown above. For JH and OHJ, these files are
; copied to the HTMLSubdir; GraphCopyFiles specifies those copied to
; the GraphSubdir, and the JavaRootFiles (*.xml, *.hs, and *.jhm) are
; copied to the top level and should not be included in WrapCopyFiles.
; Likewise, the CssCopyFiles should not be included in WrapCopyFiles.
; EmptyWrapPath = Yes (default, remove all files before copying)
; or No (leave old files in place in WrapPath directory)
; CopyCssFrom = path to directory containing the .css files, relative OK
; CssCopyFiles = list of files to copy from CopyCssFrom and output
; directories to the [CSS]CssPath (which defaults to the WrapPath),
; separated by spaces, wildcards and paths (relative and absolute)
; allowed, no spaces within an item, default is: *.css *.xsl
; For JH and OHJ, these files are copied relative to the HTMLSubdir.
; CopyGraphicsFrom = path to dir containing the graphics files, relative OK
;CopyGraphicsFrom=..\graphics2
; GraphCopyFiles = list of files to copy from CopyGraphicsFrom and output
; directories, separated by spaces, wildcards and paths (relative and absolute)
; allowed, no spaces within an item, default is: *.gif *.jpg *.png *.svg
; For JH and OHJ, these files are copied to the ./graphics subdirectory.
; EmptyGraphPath = No (default, leave graphics files in place)
; or Yes (empty GraphPath directory before copying)
; ArchiveCommand = zip command given *without* any parameters; if program
; directory is not on the system PATH, include its path, quoted if spaces.
; If omitted, archiving is not done; if present, result is put in ShipPath.
; ArchiveStartParams = any parameters preceding the name of the archive file,
; default is empty. Specify "-add" for pkzip.
; ArchiveEndParams = any parameters following the name of the archive file,
; default is empty. Specify "*.*" for pkzip.
; ArchiveName = name for archive to be created, without extension, to be
; used if ArchiveCommand is specified. Default for MSHH is HHPFileName,
; for OH [OmniHelpOptions]ProjectName (but without prefix or suffix),
; for JH and OHJ HSFileName, for others PrjFileName without path.
; ArchiveVer = version number if any to be appended to ArchiveName
; ArchiveExt = the correct extension to be added for the archive type,
; ShipPath = path to dir to contain final result file of archiving or of
; compilation (.chm, .jar, or .zip), may be the same for several projects.
;ShipPath=D:\deliverables\new_versions
; MoveArchive = No (default, copy archive to ShipPath) or Yes (move
; archive to ShipPath instead of copying it)
; EmptyOutputDir = Never (default), Book (when running a full book),
; or File (for running a single-file project with no external links).
; EmptyOutputFiles = list of files to delete, separated by spaces,
; wildcards allowed but not paths, no spaces within an item, default
; for HTML and XHTML "*.htm *.html *.ref *.grx", fir DITA "*.dita
; *.ditamap *.bookmap *.ref *.grx", and for XML "*.xml *.ref *.grx".
; Do not use "*.*" or "*.ini".
; DeleteExistingMIF = No (default) or Yes (delete *.mif from the
; output directory before the conversion if UseExistingMIF is not set).
; LogAuto = No (default) or Yes (log all automation commands to the
; OnlyAuto = No (default) or Yes (only run automation commands, used
; to save time while working out automation paths and other setings)
; RunfmDiagnostics = No (default) or Yes (include more diagnostic
; messages in the Frame console file when running from runfm)
; The book start and end commands below can contain the variables:
; <$$_basename> = base name (without path or ext) of current book
; <$$_prjpath> = path to source directory (with .prj file), no ending slash
; <$$_currpath> = path to current directory (with .ini), no ending slash
; They can also contain any entry in [UserVars], below, within <$$...>.
; BookStartCommand = command line to be run at the start of book processing
; BookEndCommand = command line run at end (after help compiler and archiving)
; BookCommandWindow = Hide (default, no display), Keep (show until user
; dismisses), Show (during execution only)
; The file start and end commands apply when the selection is a doc
; rather than a book file; they are similar to the book commands, except
; that the file commands can be overridden in a specific filename.ini.
; FileStartCommand = command line to be run at start of file processing
; FileEndCommand = command line run at end (after compiler and archiving)
; AskForUserVars = Never (default), Always, or Once (then set to Never)
; These variables can be used in the book commands above, the macros
; used in HTML output, or both. Enclose them in <$$...> like other
; macro variables. This section is searched after the [MacroVariable]
; section in this file, but before the same section in the macros file.
; When using AskForUserVars, use the starting content to explain what
; is wanted for the value (requested just before the BookStartCommand).
;version=Specify the version of the doc product
; var name = prompt to use when the value is requested, default is:
; Edit content of variable, or supply new content:
;version=Enter current version number:
; These options control operation of macros; they were formerly in
; [HTMLOptions], and are still recognized there for back compatibility.
; MacroFile = name of HTML macro library file, ext .ini, path optional
; checked for macro section if no matching section found here first;
; macro files can name a macro file too, the search proceeds up the
; chain until there are no more macro files or the macro or var is found.
MacroFile=d:/path/to/m2hmacro.ini
; FixMacroQuotes = No (default) or Yes (change baseline and curly quotes)
; OmitMacroReturns = No (default) or Yes (omit macro linebreaks in output)
; MacroVarNesting = Yes (default, vars contain <>) or No (first > ends var)
; ReplaceFrameVars = No (default) or Yes (replace Frame variables with
; the correspondingly named macro variable, if any)
; MacroNestMax = maximum depth of macro calls in one statement
; used to prevent runaways when macros call each other in circles
; RepeatMax = maximum count for <$_repeat> when value is not given, so that
; loop continues until a <$_break cond> is met
; WhileMax = maximum count for <$_while>, to prevent runaways; the current
; count can be accessed using the predefined macro variable <$$_wcount>
; NameUndefinedMacros = No (default) or Yes (insert $macro name in output)
; NameUndefinedMacroVars = No (default) or Yes (insert $$macrovar name in output)
;Title = default title for HTML files, overridden by all other settings
; UseFileIDs = Yes (default, xrefs and ObjIDs) or No (single file only)
; FileSuffix = suffix used in xrefs for HTML: htm (default), html, etc.
; ObjectIDs = All (default), Referenced (only keep if used in TOC, IX) or
; None. The .ini is set to All for Help formats, Referenced for others.
; XrefType = Full (default) or Numeric (shorter for more efficient use)
; RemoveWordTocMarkers = Yes (default, remove markers starting _Toc) or No
; RemoveFilePaths = Yes (default, strip hyperlink and xref paths) or No
; ListMissingRefs = No (default) or Yes (identify missing xrefs to stderr)
; NoSplitXrefs = No (default) or Yes (referenced files are never split)
; CheckAllRefs = Yes (default, even if they seem unchanged) or No (faster)
; NoLocations = No (default) or Yes (suppresses the part of all links after
; the filename, so that all links go to the start of the split file rather
; than to the CR marker or Hypertext newlink marker location. This is
; equivalent to setting NoRef for all paragraph styles in [HtmlStyles].
; UseRawNewlinks = No (default, remove punctuation, spaces) or Yes (as is)
; NoParaClose = No (default) or Yes (suppress </p> closing tags)
; NoWrap = No (default) or Yes (prevents returns within an HTML paragraph)
; PageBreaks = Rule (<HR>), None (default), or Split (before heads only)
; RunInHeads = Runin (default) or Normal (head on separate line first,
; UseRunInTag = No (default, get tag from body para) or Yes (from runin)
; ExtractEnable = Yes (allow extract files) or No (default, disable)
; UseHyperColor = No (default) or Yes (treat any non-black as hyper)
; AllowOverrides = Yes (default) or No (ignore untagged char properties,
; NoFonts = No (default, use <font...> tags) or Yes (prohibit <font ...>
; tags except for symbol fonts, default if UseCSS=Yes)
; NoSymbolFont = No (default, use <font...> tags for symbol fonts) or
; Yes (prohibit <font...> tags even for symbol fonts)
; UseFontFace = Yes (default, allow face attribute in font tags) or No
; Basefont = Yes (default) or No (no <basefont> tag put out)
; Default is reversed to No if UseCSS=Yes.
; AlignAttributes = Yes (default) or No (no align attribute in paragraph tags)
; Default is reversed to No if UseCSS=Yes.
; MinimizeLines = No (default) or Yes (remove extra newlines inserted in file)
; XMLBreakPara = No (default, each Shift+Enter becomes a space) or Yes
; (close para tag and reopen without attributes). Applies to XML formats
; only, and not to XHTML or HTML; in Preform-type tags, Shift+Enter is
; always a line ending regardless of this setting.
; DefaultTarget = name of target to use for all jumps not otherwise set
; URLTarget = name of target to use for all message URL links unless
; RemoveFramesAbove = No (default) or Yes (can be overridden in HtmlStyles)
; RemoveFramesBelow = No (default) or Yes (can be overridden in HtmlStyles)
; HTMLVersion = version to support, 4 (default), 3 (JavaHelp), or 2 (old)
; UseFrameSet = No (default) or Yes (if you have included frameset tags)
; UseDOCTYPE = Yes (default) or No (when writing DocBook entity files)
; HTMLDocType, the PUBLIC identifier required at start of HTML documents
; Default for v4 is: "-//W3C//DTD HTML 4.01 Transitional//EN"
; or if frameset is: "-//W3C//DTD HTML 4.01 Frameset//EN"
; Default for v3 is: "-//W3C//DTD HTML 3.2 Final//EN"
; Default for v2 is: "-//IETF//DTD HTML 2.0//EN"
; Default for XHTML is: "-//W3C//DTD XHTML 1.0 Transitional//EN"
; Uncomment and give alternate if needed, do not leave blank uncommented
;HTMLDocType="-//W3C//DTD HTML 4.01 Transitional//EN"
; HTMLDTD, the optional SYSTEM identifier in <!DOCTYPE>; default is to omit.
; If you want to add it back, although it breaks CSS usage, for v4 it is:
; "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd"
; "http://www.w3.org/TR/1999/REC-html401-19991224/frameset.dtd"
; "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"
; Uncomment and leave blank for no DTD (v2 and v3), or give an alternate.
; ValidOnly = No (default, allow normal use of chars from 128 to 160), or
; Yes (for warning-free W3C validation, remaps or removes those chars)
; AllowNobr = Yes (default, use <nobr> tags around nonbreaking hyphens,
; supported properly by all browsers), or No (required for W3C validation)
; GeneratorTag = Comment (dwhtm version in comment) or Meta (generator tag)
; XHNamespace default for XHTML 1.0 is "http://www.w3.org/1999/xhtml"
; Uncomment and give alternate if needed, do not leave blank uncommented
;XHNamespace=http://www.w3.org/1999/xhtml
; XHLangAttr = xml:lang (default, set as needed; DocBook wants just lang)
;UseXMLDeclaration = Yes to start with <?xml...?>, No for some browsers
; XMLVersion default is "1.0".
; XMLEncoding default is "UTF-8", entities are used for ANSI chars
; UseXMLRoot = Yes (default) or No (when writing DocBook entity files)
; XMLRoot default is "html" for XHTML, or "doc" for generic XML.
; QuotedEncoding = No (default, W3C usage, required for JavaHelp), or Yes
; (put encoding in meta tag in single quotes, needed by some older browsers)
; UseHeadAndBody = Yes (HTML/XHTML default) or No (generic XML and DITA)
; BodyContentOnly = No (default) or Yes (omit prolog, root element, and
; head and body tags, leaving only body content, for DBMS use)
; Ansi = Windows code page to use for FrameMaker font, default 1252,
; or 1250 for CE/EE, 1251 for Cyrillic, 1253 for Greek, 1254 for Turkish
; Encoding = UTF-8 (XML default), ISO-8859-1 (HTML default, numeric refs),
; or None (write 0x80-0xFF as single characters)
; NumericCharRefs = Yes (default, always use &#nnn;) or No (use UTF-8 for XML)
; ContentType = text/html (default for HTML and XHTML) or application/xml
; (default for XML); try not to use text/xml (for interoperability)
; These specify alphanumeric chars to use as space replacements in IDs
; if non-alphanumeric, spaces are stripped instead (default)
; ClassSpaceChar = alphanumeric char to use in CSS class names
; XrefSpaceChar = alphanumeric char to use in xref markers
; HyperSpaceChar = alphanumeric char to use in hyperlinks (except URLs)
; Footnotes = Jump (HTML default, at end), Embed (between []),
; Inline (XML default), or None
; NoFootnoteLinks = No (default) or Yes (eliminate links to footnotes)
; FootnoteSeparator macro is used at end of doc before Jump footnotes
;FootnoteSeparator=<br><br><hr>
; FootnoteStartCode macro is used after <a name=...> of each Jump footnote
; FootnoteEndCode macro is used at end of each Jump footnote
; FootClass = name to use for CSS class for footnotes, default "footnote"
; TbFootClass = name to use for CSS class for table footnotes
; UseFootnoteLists = Yes (default, use <ol> and <li> for footnotes
; except for those using symbols), or No (always use <div> and <p>).
; FootInlineTag = tag for beginning and ending inline footnotes
; FootInlineParaTag = tag for beginning and ending inline footnote paras
; FootInlineIDPrefix = start of ID attr for inline footnotes; rest
; is sequential number starting with 1 at start of file.
; UseFootXrefTag = No (HTML default) or Yes (XML default)
; FootInlineRefTag = tag for xrefs to inline footnotes, uses linkend
; for href attribute, for DocBook
; ConversionDPI = 96 (default), used when converting sizes to pixels
; ReAnchorFrames = Yes (default, anchor unanchored frames to first para
; on page) or No (skip unanchored frames)
; UseSpacers = Yes (HTML default, use to position tables and graphics)
; PixelSpacerImage = name of 1-pixel transparent GIF to use for spacing
; SpacerAlt = text to use for alt attribute for spacer, default [spacer]
; WriteSpacerFile = Yes (default, write spacer file after conversion) or No
; These settings are for the <$_madewith> macro, which adds a Mif2Go label
; where it is used (normally in an [Insert] at the bottom of the HTML page).
; WriteMadeWithGraphic = Macro (default, write graphic if its macro is used),
; Always (even if macro is not used) or Never (even if macro is used).
; MadeWithImageFile = name to use for "Made with Mif2Go" .jpg graphic
MadeWithImageFile=madewithm2g.jpg
; MadeWithPara = Yes (default, put macro inside <p>...</p> tags) or No
; MadeWithLink = Yes (default, use link to omsys home page in macro) or No
; MadeWithAttributes = attributes of <img> tag to use for macro
MadeWithAttributes= border="0" alt="Made with Mif2Go" height="48" width="78"
; UseAnums = Yes (HTML default, use unless list type) or No (XML default)
; AnumTabs = Yes (default, make tab in numbering properties into space unless
; it is in [HTMLStyles] List format, in which case remove it) or No (remove)
; TabCharsPerInch = count of spaces to use in PRE for one inch of tabbing
; the default, 16, makes 1/4" tabs into 4-char, and 1/2" tabs into 8 char
; UnwrapPRE = false (default) or true (ignore soft returns in PRE text)
; ScriptType = text/javascript (default) or other MIME type
; UseRawName = No (default, make [HtmlStyles] FileName legal) or Yes
; MakeFileHrefsLower = No (default, leave case unchanged) or Yes (old)
;ATagLineBreak = Yes (default, \n before first attr) or No
; These are mainly intended for making links for Generic XML use:
; RemoveANames = No (default) or Yes (DITA, eliminate <a name=...> tags)
; RemoveATags = No (default) or Yes (eliminate <a href=...> tags)
; RemoveAHrefAttrs = No (default) or Yes (remove href attrs, keep tags)
; XMLLinkAttrs = No (default) or Yes to add attrs to <a href=..> tags:
; xml:link="simple" show="replace" actuate="user" class="url"
;ATagElement = tag to use for all link elements, default is "a"
; except for DITA, where it is "xref"
;HrefAttribute = name to use for link source attr, default href
; UseHash = Yes (default, start local hrefs with #) or No
; UseUlink = No (default, use ATagName for URLs) or Yes (use
; ulink for URLs, and url as the HrefAttribute within them)
; RemoveXrefHotspots = No (default) or Yes (remove hotspot text for
; xrefs and hyperlinks to Frame files, retain it for external URLs)
; UseListedXrefFilesOnly = No (default) or Yes (consider any xref
; target files not listed in [XrefFiles] to refer to the current file)
; This suppresses filenames for DocBook where files are in the same
; DocBook book; files not in the book must be listed in [XrefFiles].
; StartingSplit = Yes (default, allows split at start of file) or No
; SmartSplit = No (default) or Yes (suppress splits in sequences of
; heads which lack text bodies, as long as the [HelpContentsLevels]
; values continue to increase)
; KeepReplacedCharLinks = No (default) or Yes (retain hotspot href
; when CodeReplace is used for a char format, meant for IX pagenums
; and equivalent to setting KeepLink for all char-format CodeReplaces)
; <$$_splitnum> is a sequential identifier that begins at SplitNumStart
; and is incremented for each split file by SplitNumIncrement; it is
; mainly intended for use in [StyleFilePrefix], and may be formatted
; as usual for macro variables, with a default "%d" format.
; IndexSortType = Numeric (default, code-point order), Lexical (using MS strcoll
; functions), or Alpha (sort accented letters as though they are unaccented).
; IndexSortLocale = language to use for sorting index when IndexSortType is
; Lexical, default is current OS country setting. Uses MS language names.
; IndexRanges = Yes (default, include ref to every topic within range in IX)
; or No (use only refs to topics at start and end of range in IX)
; moved from [Options] but still valid there
; HideWhiteText removes any white text (standard FrameMaker behavior)
; RemoveEmptyParagraphs = No (default) or Yes (remove paras with no text)
;EmptyParaContent = string to put in otherwise-empty paragraphs
; ConditionCharTag = tag to interpolate for conditions that affect only
; part of the enclosing element, default ph for DITA and span for HTML.
; These settings are also valid, but are now deprecated, in [HtmlOptions]
; Stylesheet = None (default if no setting), Init (default set by Setup,
; write .css if not existing), Generate (overwrite .css), Class (no
; link, no write), or Use (link, no write). If anything other than None,
; defaults are reversed for settings: NoFonts, Basefont, AlignAttributes,
; GraphAlignAttributes, NoClassLists, and LinkClassIsParaClass.
; This setting is now deprecated, and replaced by the following group.
; If Stylesheet setting is present, defaults are set according to it:
; Stylesheet = None Init Generate Class Use
; WriteClassAttributes No Yes Yes Yes Yes
; WriteCssStylesheet Never Once Always Never Never
; WriteCssLink No Yes Yes No Yes
; UseCSS = Yes (default, write class attributes, write link and write
; stylesheet once by default, reverse defaults for six settings listed
; above), or No (sets defaults for the three following settings to No)
; WriteClassAttributes = Yes (default) or No (when ClassIsTag=Yes or
; WriteCssStylesheet = Once (default, only if not present), Always
; (overwrite existing stylesheet if any), or Never (when using an
; existing stylesheet, or when not using CSS at all)
; WriteCssLink = Yes (default) or No (if not using CSS, or if writing
; stylesheet link independently using a macro in [Inserts]Head)
; CssBrowserDetect= Macro reference to JavaScript code used to sniff
; browser and write link to appropriate CSS stylesheet into the HTML.
; If present, WriteCssLink is ignored; if absent, and WriteCssLink=Yes,
; a simple link to CssFileName is written into the <head>
;CssBrowserDetect=<$BrowserCSS>
; CssFileName = name of stylesheet to reference in link when
; WriteCssLink=Yes and CssBrowserDetect is absent.
; CssPath = directory in which .css (or .xsl) files are to be placed
; at runtime, default is WrapPath if specified, otherwise the output
; directory, absolute or relative (to WrapPath/output) path allowed
; CSSLinkNS4 = No (default, required for CSS validation) or Yes (NS 4.x)
; ClassIsTag = No (default for HTML/XHTML) or Yes (default for Generic XML)
; LowerCaseCSS = No (default mixed case) or Yes (lower case only, default
; for JH, OHJ, XML, and XHTML)
; UseCSSLeading = Yes (default) or No (omit linespacing in CSS files)
; NoClassLists = Yes (default, no class in <LI> tags), or No
; Default is reversed to No if UseCSS=Yes.
; NoAttribLists = No (default, use type and value in list tags), or Yes
; AlwaysNestLists = No (default, no nesting when CSS used) or Yes
; LinkClassIsParaClass = No (default) or Yes (adds the same class attribute
; as is used for the current para to all links within that para)
; Default is reversed to Yes if UseCSS=Yes.
; ZeroCSSMargins = No (default) or Yes (specify CSS margins even if zero)
; UseSpanAsDefault = Yes (default, use span as element name for all char
; formats that do not specify one in [CharStyles]) or No
; CssFontUnits = units for font size and line height, default 0,
; 0=pt, 1=pc, 2=in, 3=cm, 4=mm, 5=em, 6=ex (0.5em), 7=px (pixels), 8=%
; CssIndentUnits = units for para space and indents, default 0,
; CssFontUnitDec = count of digits to right of decimal in CSS font
; values, 0, 1, or 2, default 2. Trailing zeros are trimmed.
; CssIndentUnitDec = count of digits to right of decimal in CSS indent
; values, 0, 1, or 2, default 2. Trailing zeros are trimmed.
; CssBodyFontSize = value for body {font-size: }, used as base for all
; em and ex sizes, and for font-size and line-height %, default 10.
; CssBodyFontUnit = units for body {font-size: }, default 0, values as above
; Use absolute value like 0 (pt), not 5 (em), 6 (ex), or 8 (%).
; CssBodyFontTag = Yes (default, writes body { text-size:) or No
; CssIndentBaseSize = value used for computing percents for margin
; settings (para space above and below, and indents) in .css file
; CssIndentBaseUnit = units for CssIndentBaseSize, default 2 (in)
; Use absolute value like 0 (pt) or 2 (in), not 5 (em), 6 (ex), or 8 (%).
; Font name and size put out at start of file, default none
; html filename = title, overrides [HtmlStyles] Title setting
; for split or extract files, use FileID+UID, such as mr516387
; m2rdesc=DCL MIF2RTF Filter Description
; original html filename = desired html filename, only for split or
; extract files, not usable for files named for the original Frame file
; original filename (no ext) = prefix ID for text and graphic objects.
; If [FDK]UseLocalFileID=No (the default), the IDs in mif2go.ini are
; used instead; this section is really just to support earlier projects
; and should never be used in current projects, use mif2go.ini instead.
; original filename (no ext) = html filename (no ext, possibly with path)
; essential if there are any xrefs to or from other files that are not
; in the current directory; the default is to leave the name unchanged
; original .fm filename = path to directory containing its .ref file,
; needed for files that are referenced from files in the current book
; and that have .htm and .ref files that are not in the same output
; directory as those produced for the current book by this project
; flowtags to Skip or to treat as Normal (to keep in same section)
; Document font name = HTML font name (comma-delimited list allowed)
; HTML font size = pt size it starts with for default usage
; for example, if 3=10 and 4=14, 12pt type becomes size=3
; computed size is overridden by [HtmlStyles] SizeN setting
; color name = hex RGB value (names as used by Frame), or
; color number = hex RGB value; color number 0 is invisible
; 1..8 = black, white, red, green, blue, cyan, magenta, yellow
; more may be defined in the Frame file; this overrides them
; numbers up to 255 may be defined here and used in [HtmlStyles]
; for example, 100=804000 defines 100 as olive brown
; marker type name = one or more marker type names, can include original type.
; Names on the right cannot contain spaces or commas, but those on the left can.
; Conditional Text markers cannot be remapped; others are remapped literally.
; Original marker type names are Header/Footer $1, Header/Footer $2, Index,
; Comment, Subject, Author, Glossary, Equation, Hypertext, Cross-Ref, and HTML
; Macro. The following hypertext names are recognized: openObjectIDfitwin,
; openObjectID, gotoObjectIDfitwin, gotoObjectID, gotopage, openlinkfitwin,
; openlink, gotolinkfitwin, gotolink, newlink, alert, and message; note that
; message specifically means "message URL", and that such a marker should
; have a URL as its content. Any name not in these lists is a custom name.
; Note that many names have specific purposes, such as those for WAI attributes,
; where the Marker Type Name can start with any one of these identifiers:
; Table, to set the attribute in the enclosing table. If not positioned in
; a table, applies to the next table in the same flow.
; Row, to set the attribute in the enclosing table row.
; Cell, to set the attribute in the enclosing table cell.
; Graph, to set the attribute in the next <img> tag written.
; Link, to set the attribute in the next link (<a href=...>) tag.
; Meta, to set a <meta> tag in the <head> of the current file part.
; Any markers with Type Names starting differently are ignored by this process.
; The rest of the Type Name is used as the attribute name, so
; GraphAlt sets the alt attribute text of the next <img> tag,
; GraphLongdesc sets the <img> longdesc attribute (a URL for more info), and
; MetaKeywords sets <meta name="Keywords" content="..." /> in its file head.
; The CellGroup marker contains either "col" or "row" and acts as though
; ColGroup or RowGroup was assigned to the cell in [HtmlStyles].
; The CellSpan marker can contain anything, but must not be empty, and acts
; as though Span was assigned to a format in the cell in [HtmlStyles].
; For EclipseHelp output (only), there are three dedicated marker types:
; EclipseContext markers contain the context ID name (for CSH infopops),
; and are placed in each topic that the infopop should reference.
; EclipseAnchor and EclipseLink markers are placed in the topic preceding
; the desired anchor location; the marker content is a number for the TOC
; level, a space, and text, which is the anchor name for EclipseAnchor and
; the path to the desired TOC file for EclipseLink markers.
; Similarly, Marker Type Names beginning with JH2Pop and JH2Sec are used to
; set properties for the next JavaHelp2 link to a Popup or Secondary Window.
; Available properties are Type, Text, Size, Location, Name, Graphic, and
; text properties FontFamily, FontSize, FontWeight, FontStyle, and FontColor.
; For definitions of their content, see their [JavaHelpOptions] settings.
; Other useful Marker Type Names are TableSummary, TableTitle, CellScope,
; CellAxis, CellAbbr, and LinkTitle, all alternatives to the [HtmlStyles]
; settings. Any combination can be used, as can other types not settable
; from [HtmlStyles], such as LinkAlt.
; For example, Subject = Index ALink adds all Subject markers to the Index,
; and also makes clones of them as ALink markers for their help topic.
; This makes each HTML Macro marker into an HTMLComment marker (literal) plus
; a Code marker (with macro expansion): HTML Macro=HTMLComment Code
; Config and HTMConfig allow use of markers to set many, but not all,
; of the mif2htm.ini settings. They differ in that Config will also
; work for corresponding settings in mif2rtf.ini. They can be used
; Globals, overriding the corresponding mif2htm.ini setting, stay in
; effect until the end of the file or until reset by another marker.
; These include settings in [Options], [HTMLOptions], and many more.
; Styles, as in [HTMLStyles], affect only the current paragraph or span
; of character-formatted text.
; Tables, as in [Table] and the rest of the [Table*] sections, affect
; the entire table within which they are placed.
; Graphics, as in [Graphics] and all [Graph*] sections, affect only the
; next graphic (when placed in the text before the anchor, or in any
; text frame within the graphic).
; Xrefs, for [XrefStyles] and [XrefStyleLinkSrc], affect only the next
; xref (in the text flow); the [XrefStyles] properties replace those
; specified for the xref format in the .ini.
; For Globals, use the usual mif2htm.ini syntax: [Section]key=value. For
; the other four (object-specific) types, omit the key: [Section]=value
; if you want to affect the current object (or next graphic or xref), or
; include it if you want to affect all objects later in the text stream.
; The [TableGroup] and [GraphGroup] markers assign their object to a named
; group, so that their settings can be in a [Table*] or [Graph*] .ini section
; for that name. Note that a given object can belong only to *one* group.
; marker type name = properties: Delete, Code, HTMLComment, Window, Split,
; ExtrStart, ExtrFinish, ExtrEnd, ExtrEnable, ExtrDisable, ExtrReplace,
; ExtrHead, ExtrTop, ExtrBottom, Title, FileName, ALink, Ansi, HelpMerge,
; Config, HTMConfig, EclipseContext, EclipseAnchor, and EclipseLink.
; Ansi specifies the Windows code page to use for FrameMaker, default 1252,
; or 1250 for CE/EE, 1251 for Cyrillic, 1253 for Greek, 1254 for Turkish.
; If a type is remapped in [Markers], and the mapping does not include
; the original type name on the right, that type will not be recognized
; in this section. However, new types defined in [Markers] will be.
; Listing results in the marker no longer having its original functionality.
; Index, Hypertext, HTML Macro, and Cross-Reference Markers cannot be included
; here but can be remapped to other types in [Markers] which can be used here.
; When assigned to Code, any macros in the marker are expanded normally, and
; any [MarkerTypeCodeBefore] and [MarkerTypeCodeAfter] are used for it.
; The HTMLComment type also does correct XML comments.
; The Window type sets the name of the secondary window to be used (only in
; MS HTML Help) for accesses to the topic from the contents and index.
; For Split and Extr* types, the marker should not be empty, but any content
; is ignored (unless other properties that use it are specified).
; For example, ALinkRef = Code, with the settings below in [MarkerTypeCode*],
; creates an OracleHelp ALink reference to the link identified in the marker.
; marker type name = macro; for markers listed in MarkerTypes as Code, or
; for attribute markers such as "LinkTitle" for which Code must *not* be
; For example, ALinkRef=<a href="alink:
; marker type name = macro; for markers listed in MarkerTypes as Code, or
; for attribute markers such as "LinkTitle" for which Code must *not* be
; For example, ALinkRef=">Related Topics</a>
; HTML element = additional attributes (macro) to set
; Elements supported are: body, table, tr, td, th, thead, tfoot, tbody
; For body, bgcolor=page (background) color, text=text (default) color,
; link=hyperlink active color, alink=hyperlink color when clicked,
; vlink=visited hyperlink color, and #...... = your hex color for any of these
; You can also insert JScript, such as the "onLoad" shown here
; For tables, table rows (tr), and table cells (td/th), settings may be browser
; dependent. The table attributes are emitted after the border, cellpadding,
; and cellspacing values specified under [Tables], so they should not include
; these attributes, as that would be illegal HTML. Use [TableAttributes] instead.
; Keep all attributes for one element on one line, regardless of line length
; For XHTML, all attribute names must be lower case
; body= bgcolor="#FFFFE1" text="#000080" link="#008020" vlink="#804000" onload="if (self != top) top.location = self.location"
; Condition name = attributes for elements, where the DITA attribute
; name is usually one of props, platform, product, audience, or
; otherprops. For HTML, the attribute name is usually class.
; ConditionName = Yes to show or No to hide. Any not mentioned
; are left in their current state; any not found are ignored.
; Document para style name = HTML style name (default is <P>)
; use H1-H6, PRE, SCRIPT, ADDRESS, or BLOCKQUOTE for HTML styles
; for XHTML, all styles must be lower case
; Document character style name = HTML starting element name(s)
; use STRONG, EM, CODE, CITE, VAR, BLINK, or SPAN for HTML elements
; anything specified will be used around the styled text segment
; for XHTML, all styles must be lower case
; Document style name = class to use (default is based on name)
; For XML, the class is used as the tag name by default.
; UseTypographicElements = Yes (HTML default) or No (XML default,
; suppress b, i, u, tt, sub, and sup even when specified in a format)
; UseFormatTypographics = Yes (default, use b, i, u, strike, sub
; and sup when set in paragraph or character formats), or No
; (suppress in both para and char formats)
; UseParagraphTypographics = Yes (default, use above when set in
; paragraph formats), or No (suppress in para formats)
; UseCharacterTypographics = Yes (default, use above when set in
; character formats), or No (suppress in char formats)
; UseTypographicStyles = No (default) or Yes (use tags below if set
; typographic tag (b, i, u, strike, sub, sup) = tag to use instead,
; possibly followed by attributes. Replaces overrides if used
; while [HTMLOptions]AllowOverrides=Yes, UseTypographicElements=Yes,
; and UseFormatTypographics=No.
; Frame font name = section to use for mapping chars in that font
; Same syntax as [CharConvert], below, Unicode char num = num or string
; char n = square bullet, char p = graphic
; Unicode char num = HTML numeric value or string replacement
; The unicode num can be decimal or "x" followed by hex; for chars
; less than xFF, it can also be the char itself. The replacement
; number can also be decimal or "x" plus hex; a replacement string
; can include macros such as <$MyProc> which are expanded. When a
; string rather than a number is provided, it is not encoded further.
; nonbreaking hyphen is x2011, decimal 8209, becomes entity –
; em space is x2003, becomes three nonbreaking spaces
; UseCALSModel = No (HTML default) or Yes (XML default)
; StripTable = No (default) or Yes to remove all table tagging while
; retaining the cell content for browsers that lack table support.
; Sets AllowTbSplit and AllowTbTitle by default, can be overridden.
; Border, Spacing and Padding defaults for full table
; TableAttributes = Yes (HTML default, to allow above values), or
; No (XML default, to exclude those while keeping any attributes
; explicitly added in the .ini or in markers).
; The next two can be used to eliminate the automatically-generated cell
; attributes, but leave those specified in the .ini or in markers.
; CellAlignAttributes = Yes (HTML default) or No (XML default, eliminate
; automatically-generated align and valign)
; CellColorAttributes = Yes (HTML default) or No (XML default, eliminate
; automatically-generated bgcolor)
; TableSizing = Adaptive (default), Fixed (pixels), Percent (of table)
; used for setting width attribute in cells, not in the table element
; overridden for particular tables and groups in [TableSizing] section
; TableIndents = -1 (based on indent in FM), 0 (none), or count of pixels
; overridden for particular tables and groups in [TableIndents] section
; TableDPI = 96 (for Fixed, gives 624 pixels for 6.5" page
; InternalTableCaption = Yes (default) or No (put outside table)
; TableTitles = 0 to leave alone, 1 to put at top, 2 to put at bottom
; TableCaptionTag = tag for internal table captions, default "caption"
; UseTbHeaderCode = No (default, always use <td...>) or Yes (use <th...>)
; UseAltShading = No (default) or Yes (alt row/col shading as in Frame)
; UseRowColor = No (default) or Yes (set bgcolor for <tr> tag)
; overridden on table ID basis by [TableUseRowColor] settings
; RemoveEmptyTableParagraphs = No (default) or Yes (DITA/DocBook default)
; EmptyTbCellContent = string to put in otherwise-empty table cells
; TableWordBreak = No (default) or Yes (to force line breaks in tables
; when the break happens after a word-break hyphen, to fix browser bug)
; TableFootnotesWithTable = No (default) or Yes (put after separator)
; TableFootnoteSeparator = macro between table end tag and footnotes
;TableFootnoteSeparator=<br />
; TableContinued = No (default) to remove variable from table titles
; TableContVar = name of the variable used for table (continued)
TableContVar=Table Continuation
; TableSheet = No (default) to remove this variable from table titles
; TableSheetVar = name of the variable used for table (Sheet m of n)
; AllowTbSplit = No (default) or Yes (allow file split for head in table)
; AllowTbTitle = No (default) or Yes (allow title from head in table)
; UseInformaltableTag = No (default) or Yes (use when there is no
; table caption, as in DocBook)
;For WAI, AccessMethod = None (default), Scope, or IDheaders
; sets the basic policy for adding accessibility for tables
; Scope sets ScopeColGroup, ScopeRowGroup. ScopeCol and ScopeRow.
; It sets ColSpanIDs and RowSpanIDs for other straddling header cells
; (for lack of a better alternative; there's no scope for spans).
; IDheaders sets ColGroupIDs, RowGroupIDs, ColSpanIDs, RowSpanIDs,
; ColIDs, and RowIDs, so that most header cells have IDs and the
; corresponding body cells have matching headers.
; HeadFootBodyTags = No (default) or Yes (to wrap table rows in <thead>,
; <tfoot>, and <tbody> groups; needed to enable scope="rowgroup")
; FootTagLast = No (default, put after thead) or Yes (keep NS4 happy)
; ColGroupElements = No (default) or Yes (to put out <colgroup> elements
; before first table row; needed to enable scope="colgroup")
; TableHeaderCols = count of cols in which to treat cells as headers,
; counting from left at the start of each row in the table
; TableHeaderRows = count of rows in which to treat cells as headers,
; counting from the top of the table
; TableFooterRows = count of footer rows from bottom of the table,
; significant only when HeadFootBodyTags = Yes.
; ScopeColGroup = No (to not use) or Yes (to apply scope="colgroup"
; instead of "col" to column head cells identified as ColGroup via
; [HtmlStyles] or the CellGroup marker col; sets ColGroupElements).
; ScopeRowGroup = No (to not use) or Yes (to apply scope="rowgroup"
; instead of "row" to row head cells identified as RowGroup via
; [HtmlStyles] or the CellGroup marker row; sets HeadFootBodyTags).
; ScopeCol = No (to not use) or Yes (to apply default scope="col"
; to non-empty cells in table header)
; ScopeRow = No (to not use) or Yes (to apply default scope="row"
; to first non-empty cell in each row in the table)
; ColGroupIDs = No (default) or Yes (to use id="groupN" in col head cells
; identified as ColGroup via [HtmlStyles] or the CellGroup marker col)
; RowGroupIDs = No (default) or Yes (to use id="groupN" in row head cells
; identified as RowGroup via [HtmlStyles] or the CellGroup marker row)
;RowIDs and ColIDs set row and col IDs in table header cells
; and the matching headers attribute in table body cells
; ColIDs = No (to not use), or Yes
; adds id=colN to first cell in header row of each column
; adds headers=colN to each cell below in the same column(s),
; RowIDs = No (to not use), or Yes
; if ColIDs are used, does not affect all the header rows.
; adds id=rowN attribute to the first cell of each body row,
; adds headers=rowN to each following cell in that row,
;Span is more flexible, and can be used with row and col
; ColSpanIDs = No (to use only per markers or formats), or Yes
; adds id=spanN to each cell in header rows that spans columns,
; or that has a CellSpan marker, or contains any para formats
; with [HtmlStyles] Span, increments for each one used.
; adds headers=spanN to all cells below the spanning cell.
; RowSpanIDs = No (to use only per markers or formats), or Yes
; adds id=spanN to first cell in each row if it spans rows, or
; if it has a CellSpan marker, or if it has any para formats
; with [HtmlStyles] Span, increments for each one used.
; adds headers=spanN to all cells right of the spanning cell.
; if ColSpan used, first ID numerically follows last ColSpanID.
; ColGroupHead is "group" by default; it is used in the id attrs
; of header cells containing a para format with [HtmlStyles]ColGroup.
; RowGroupHead is "group" by default; it is used in the id attrs
; of left cells containing a para format with [HtmlStyles]RowGroup.
; If ColGroup is used, first ID numerically follows last ColGroup ID.
; ColHead is often seen in examples as "header", but this is
; not essential; it can be any useful identifier: