Specifications

Chapter 10112
TagChooser.xml files are stored in Configuration/TagLibraries/TagLibraryName folder. The
following example illustrates the structure of TagChooser.xml files:
<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>
<tclibrary name="Friendly name for library node" desc=’Description for
incorporated reference’ reference="Language[,Topic[,Subtopic]]">
<category name="Friendly name for category node" desc=’Description for
incorporated reference’ reference="Language[,Topic[,Subtopic]]"
id="Unique id">
<category name="Friendly name for subcategory node" ICON="Relative path"
desc=’Description for incorporated reference’
reference="Language,Topic[,Subtopic]" id="Unique id">
<element name="Friendly name for list item" value=’Value to pass to
visual dialog editors’ desc=’Description for incorporated reference’
reference="Language[,Topic[,Subtopic]]" id="Unique id"/>
... more elements to display in the list view ...
</category>
... more subcategories ...
</category>
... more categories ...
</tclibrary>
The following table lists the tags that are available for use in the TagChooser.xml files:
The
CATEGORY tag represents all other nodes in the Tree view under the TCLIBRARY’s node, as
shown in the following table:
Tag Description Mandatory/
Optional
tclibrary The tag is the outermost tag, which encapsulates
this Tag Library’s Tag Chooser structure.
Mandatory
tclibrary.name Value appears in the Tree view node. Mandatory
tclibrary.desc Value is an HTML string and is displayed in the
Tag Info section of the Tag Chooser dialog box. If
there is no DESC attribute, the information for Tag
Info comes from the Reference panel.
Interchangeable with tclibrary.reference.
Optional
(desc and
reference are
mutually exclusive)
tclibrary.reference Value describes the language, topic, and subtopic
to display in the Tag Info section of the Tag
Chooser dialog box. Interchangeable with
tclibrary.desc.
Optional
(desc and
reference are
mutually exclusive)
Tag Description Mandatory/
Optional
category.name Value appears in the tree view node. Mandatory
category.desc Value is an HTML string that appears in the tag
info section of the Tag Chooser dialog box.
If
neither desc nor reference attr is specified,
nothing appears in the Tag info section.
Optional
(desc and
reference are
mutually exclusive)
category.reference Value describes the language, topic, and subtopic
to display in the Tag info section.
Optional
(desc and
reference are
mutually exclusive)