24.8.1.2 Identifying the starting element for glossary topics

For glossary topics (DITA version 1.1+ only), the required starting element is <glossterm>. Unless the default topic type is glossary, you must tell DITA2Go that the topic start is the paragraph format mapped to glossterm in [DITAParaTags].

You do not have to specify parents for glossary elements, because <glossterm> and <glossdef> can have only <glossentry> as parent; and you do not have to specify an element level for the format mapped to glossterm, because it will always be level 1.

Glossary in a separate file

If the glossary for your document is in a separate file, not mixed with other types of topics, create a file-specific configuration file glossfile.ini, and include in it the following setting:

[DITAOptions]
DefTopic = glossary

See §24.8.2.2 Specifying a default DITA topic type.

Setting the default topic type to glossary tells DITA2Go that the topics in the current file start with the paragraph format mapped to glossterm in [DITAParaTags]:

[DITAParaTags]
ParaFmt = glossterm

See §24.4.3 Mapping paragraph formats to DITA block elements.

Glossary mixed with other topics

If the glossary for your document is in a file that includes other topic types, you must make the starting paragraph format for the glossary topic different from the starting formats for all other topic types in the file; and you must assign topic type glossary to that format in [DITATopics]. For example:

[DITATopics]
; Every GlossaryTerm paragraph begins a glossary topic:
GlossaryTerm = glossary

[DITAParaTags]
; Every glossary topic begins with a <glossterm> element:
GlossaryTerm = glossterm
Definition = glossdef

Previous Topic:  24.8.1.1 Identifying starting elements for non-glossary topics

Next Topic:  24.8.1.3 Preventing the first paragraph format from starting a topic

Parent Topic:  24.8.1 Designating starting points for DITA topics

Sibling Topics:

24.8.1.1 Identifying starting elements for non-glossary topics

24.8.1.3 Preventing the first paragraph format from starting a topic

Table of ContentsIndex