32.3 Preparing a content model for use with Mif2Go

If you plan to use a built-in content model as is, you do not need to do anything described in this section.

To prepare a new, modified, or replacement content-model configuration for use with Mif2Go:

1. Inspect and (if necessary) change element type assignments; see §32.6 Inspecting and correcting element types.

2. For DITA only, if you are adding or replacing a content model, provide information needed by Mif2Go that is not available in the DTD:

• Most settings in section [Topic] except for TopicRoot; see §32.4.1 Content model [Topic] settings.

• Table structure information; see §32.7.7 Providing table structure information for DITA topic types.

If you generated the content model from a DTD and you plan to rerun dtd2ini, also include in configuration file dtd2ini.ini as overrides any [Topic] and [*Table] settings you add. See dtd2ini.txt for instructions.

3. Include the following setting in the content-model configuration file:

[Topic]

; 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 the project configuration file;

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

ModelName = contentmodelname

ModelName specifies either the name of an existing content model to be replaced by the current content model, or a name for the new content model to be added.

If you are replacing a built-in content model, the value for ModelName must be one of the following, depending on the output type: 

Output type	Built-in content model to be replaced by current model
DITA 1.0	topic, concept, task, reference, or map
DITA 1.1	topic, concept, task, reference, map, glossary, or bookmap
DocBook	book or article

If you assign any other value to ModelName, Mif2Go adds the new name to the list of models. For example, to add a new DITA topic type widget defined in content-model configuration file DITAwidget.ini, in DITAwidget.ini you would include the following setting:

[Topic]

ModelName = widget

To replace the built-in DITA reference content model with a model you have defined in content-model configuration file DITAmyref.ini, in DITAmyref.ini you would include the following setting:

[Topic]

ModelName = reference

4. Place the new or modified content-model configuration file in your DITA or DocBook project directory.

5. Specify the base name of the content-model configuration file in your project configuration file:

For DITA, add the base name of each new or modified content-model configuration:

[DITAContentModels]

; Topic type name = any text (not used)

DITAtopictype = replaced or new topictype content model

For DocBook, specify the base name of the new or modified content-model configuration:

[DocBookOptions]

; ContentModel = name of content-model .ini, without extension,

;  with which to replace the built-in DocBook 4.5 content model.

ContentModel = otherdocbookmodel

---

> 32 Working with content models > 32.3 Preparing a content model for use with Mif2Go