Macromedia dreamweaver 8-extending dreamweaver User Manual

Page of 504
268
Tag Libraries and Editors
The Tag Chooser
The Tag Chooser lets you view tags in functional groups so you can easily access frequently 
used tags. In order to add a tag or a set of tags to the Tag Chooser, you must add them to the 
tag library. You can do this by using the Tag Library Editor dialog box or by installing a 
Dreamweaver extension, which is packaged in an MXP file
.
TagChooser.xml files
The TagChooser.xml file provides the metadata for organizing tag groupings that appear in 
the Tag Chooser. Each tag that comes with Dreamweaver is stored in a functional grouping 
and is available in the Tag Chooser. By editing the TagChooser.xml file, you can regroup 
existing tags and group new tags. You can customize how tags are organized for your users by 
creating subcategories so they can easily access their most important tags. 
The TagLibraries.vtm file supports the use of the 
TAGLIBRARY.TAGCHOOSER
 attribute, which 
points to the TagChooser.xml file. If you change existing TagChooser.xml files or create new 
ones, the 
TAGLIBRARY.TAGCHOOSER
 attribute must point to the correct location for the Tag 
Chooser to be fully functional.
If there is no 
TAGLIBRARY.TAGCHOOSER
 attribute, the Tag Chooser displays the tree structure 
that is in the TagLibraries.vtm file.
TagChooser.xml files are stored in the Configuration/TagLibraries/TagLibraryName folder. 
The following example shows 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>