Omni Systems, Inc.


Mif2Go User's Guide, Version 55


Valid HTML 4.01!


Made with Mif2Go

> F Content model configuration

F Content model configuration

This section provides an annotated list of configuration sections, keywords, and acceptable values for settings in content-model configuration files.

See also:

§32 Working with content models


; ContentModel.txt describes sections used in DITAspecial.ini files,

; such as DITAconcept11.ini, as they are supported in dwhtm.dll h283.

; Most of it also applies to DocBook content model files; differences

; are marked in the descriptions below.



;ModelName = name of type (usually a built-in) to be replaced after

; this file loads, effective only when this file is specified in

; [DITAContentModels] or [DocBookOptions]ContentModel in mif2htm.ini;

; overrides the default use of the filename (without "DITA").



; TopicRoot = name of root element in the DITA or DocBook file for

; this type.



; These two are DITA-only, not for DocBook:

; TopicStart = name of element that starts topic, such as "glossterm"

; (for glossary) or "title" (for every other type). When the Frame

; format mapped to this element in [DITATags] is also mapped to

; level 1 in [DITALevels], that format always starts a new topic.


; TopicBody = name of its body element, such as conbody for concept.



; PrologDType = PUBLIC name used in DOCTYPE header, double quotes

; are required.

PrologDType="-//OASIS//DTD DITA Concept//EN".

; PrologDTD = SYSTEM name, such as "concept.dtd", can include a path,

; double quotes are required.



;TopicDerivation = name of type from which it is derived, either one of

; the defined types (topic, concept, task, reference, glossary, or map)

; or another specialized type for which an .ini is available. Needed

; iff the description in the rest of the sections is additive rather

; than complete in itself; omitted otherwise. Not used for .inis that

; were generated by dtd2ini, which are always complete.



;DumpToFile = name with optional path of file in which to dump the

; tagset information (including error lists) after loading, for debug;

; default none, meaning don’t dump. If the tagset is used more than

; once in processing the Frame file, it is dumped only the first time.




; For DITA working examples of the following sections, see the files

; DITAtopic*.ini, DITAconcept*.ini, DITAtask*.ini, DITAreference*.ini,

; DITAglossary*.ini, DITAbookmap*.ini and DITAmap*.ini, where * is

; 10 for version 1.0 and 11 for version 1.1. DocBook examples are

; docbook45b.ini (book as root) and docbook45a.ini (article as root).



; Element name = possible parents. All elements other than the topic

; type itself, amd its body type, must be listed on the left here.

; The two reserved parent names are "Any" (any parent is acceptable,

; mainly for inline elements) and "No" (for any elements present in

; the derived-from type that are excluded from this type). If there

; is more than one possible parent, they must be defined as a single

; set, and listed in [ElementSets] below.



; Name for set = list of elements. This allows grouping of elements

; for use on the right side of [TopicParents] and [TopicFirst], so

; that the same set of parents can be used for more than one element.

; The lists of elements on the right here can include sets too, as

; building blocks. The sets are roughly equivalent to the parameter

; entities used in the DITA DTDs. Set names must start with "*", and

; sets can include other sets. Included sets should preferably be

; defined above the sets including them; in any case, circular set

; references (set A includes set B and set B includes set A, directly

; or indirectly) will not work.



; Element name = list of properties: Block or Inline, Text, and

; Preform; default is Block without Text. The Block and Inline

; properties determine whether returns are inserted before start

; tags and after end tags. The Text property determines whether

; an attempt is made to wrap any invalid text (in an element that

; does not allow Text) in a valid container element, like <ph>.

; Preform determines whether whitespace within the element is

; retained as is; those elements are always block and allow text.

; For example:

para=Block Text

ph=Inline Text



codeblock=Block Text Preform



; Element name = required level in topic, used only for elements that

; must be at a specific level, such as shortdesc, prolog, body, and

; related-links at level 1, and example and metadata at level 2.

; The content models generated by dtd2ini name only level 1 elements.



; Child element = parents, where child must be the first child of the

; specified parents; if child is not first, the current parent is

; closed and a new instance of it is started. Used mainly for lists,

; as in dt=dlentry and pt=plentry, and for title=Any. To add more

; than one parent when Any won’t do, specify them in [ElementSets].



; The remaining sections are used for DITA only, not DocBook:



; Table name = name of section that describes it below. All supported

; by this topic type (other than those defined in the type derived from)

; are defined here. Note that multiple named tables can define variants

; of the same DITA TableType; the name is purely a Mif2Go identifier.

; A name can be undefined in a derived topic type by setting name=No.

; Since dtd2ini does not generate these sections, they must either be

; included in dtd2ini.ini as [AddedSections], or added to the generated

; content model .ini manually after dtd2ini produces it.


; These examples of table descriptions show all available table settings.




;ColCountMax default is 0, for unlimited, as for simpletable



;HeadRowMax default is 0, for unlimited head rows.


; HeadRow is applied only to the initial rows, iff they are head

; rows in the Frame file.


; All cells are used; to omit some, define another table name with

; fewer columns but the same TableType.



















; TableTitle default is No, for no title.


; TableDesc default is no desc.


; TableGroup default is no group’


; ColSpec default is no column specs


; The next three items are all colspec attributes


; ColSpecName is required if ColSpanNames=Yes or ColName is

; used, below. It is created using ColNamePrefix, below.




; HeadGroup default is no group, use head rows only.


; HeadRow Default is same row element as for body.


; HeadCell default is same cell element as for body



; BodyGroup default is no group, use body rows only.





; RowSpan is a cell attribute name; default is no rowspan.



; ColSpanNames default is true to use names, false uses count.


; The next four settings are all cell attributes.

; ColSpanCount is count of cells spanned, if ColSpanNames=No.


; ColSpanStart is ref to first colspec name if ColSpanNames=Yes.


; ColSpanEnd is ref to last colspec name if ColSpanNames=Yes.


; ColName is ref to single colspec name for non-spanning cells.


; ColNamePrefix is for colspec names, default col as in DITA-OT.


; CellAlign default is No, when Yes use align and valign attrs.






> F Content model configuration