User Guide

Working with tag definitions 125
Working with tag definitions
Every tag in HomeSite+ for Dreamweaver MX has a definition file, written in VTML,
that specifies the valid attributes for the tag and the content and formatting of the tag
editor for the tag. Tag definitions are the source of information for tag editors, Tag
Insight, Tag Tips, and Tag Inspector.
Following are the namespaces for the tag definitions that are installed with
HomeSite+ for Dreamweaver MX: XHTML, HTML, CFML, VTML, JSP, Java, JRUN,
WML, HDML, SMIL, IMFL, RTML, and Custom.
About namespace precedence
A version of a markup language (or namespace) can have a tag with the same name
as a tag in another namespace. For example, both the JRun and Java namespaces
contain a servlet tag. To avoid conflicts, the tag definitions for different namespaces
are installed in different directories, in the \Extensions\TagDefs directory under the
application root directory.
When you use a tag editor or the Tag Inspector, or Tag Insight is enabled, HomeSite+
for Dreamweaver MX needs to know which tag definition to use. The list in the
Options > Settings > Tag Definitions Library pane represents the order in which
HomeSite+ for Dreamweaver MX searches the directories when looking for a tag
definition.
For example, if you enter
<region> in a document, right-click it and choose Edit Tag,
the SMIL tag editor appears, because no other directory contains a <region> tag. On
the other hand, if you edit a <servlet> tag, either the Java or JRun version of the tag
editor could appear. If JRun is higher on the namespace list than Java, then the
program uses the JRun version of the servlet tag definition, without continuing its
search to discover the Java version.
The following are two ways to manually override these defaults while working in the
Editor:
• Enter the namespace and a colon (:) in the tag before the tag name; for example,
enter
<java:servlet>.
• Use Tag Chooser to insert the tag from whatever directory you want.
For more information, see “Selecting a tag from Tag Chooser” on page 53.
Setting namespace precedence
This section explains how to set the order in which the program searches namespace
directories for a tag definition.
To set the priority of namespaces:
1In the Options > Settings > Tag Definitions Library pane, click Up and Down as
necessary to set the list in the appropriate order.
The namespace at the top of the list receives the highest priority.