Tag Tree and Tag Inspector

The Tag Inspector tab of the Resource pane contains two integrated tools: Tag Tree and Tag Inspector. By using them in combination, you can edit all the code in a document without having to work directly in the document.

Tag Tree

The Tag Tree, located in the top pane, is helpful for inspecting and navigating a document's structure. It can be easily configured to display just the tags you want.

Note To use the Tag Tree:
  1. Open the drop-down list at the top of the pane to filter the view.
  2. Use the plus and minus signs to expand and contract the nodes of the Tag Tree.
  3. Click on a tag in the tree to quickly locate it in the document. Shift + Ctrl + double-click selects the entire tag block.

    If the selected tag supports attributes, they are displayed, with their values, in the Tag Inspector pane.

  4. Click the Refresh button to update the Tag Tree as you edit the document.

Note To configure the Tag Tree display:
  1. Click the Configure Outline Profiles button at the top of the pane to open the Outline Profiles dialog box.

  2. Use the Add and Remove buttons in the Outline Profiles pane to edit the current tag sets.
  3. Use the Add and Remove buttons in the Recognized Tags pane to edit the tag list for the selected set.
  4. To add a caption and icon to a tag, make selections in the Tag Settings pane.
  5. Click Done to update the Tag Tree profiles.
Note To import an Outline Profile:

The Tag Tree supports tag sets created in Allaire's Visual Tools Markup Language (VTML), or a Document Type Definition (using the DTD file extension) from an SGML-compliant language, such as Extensible Markup Language (XML).

  1. Click the Import button in the Configure Outline Profiles dialog box.
  2. Select either a VTML definition file or a DTD file to import.
  3. Click Next.

    The Wizard reports the status of the import process. If the process completes successfully, click Finish.

Tag Inspector

The Tag Inspector lets you edit code in a property sheet interface that will be familiar to Visual Basic and Delphi programmers. The four icons at the top of the Inspector pane control the way attributes and scripting events are displayed.

Note To use the Tag Inspector:
  1. Click in a tag, either in the Tag Tree or in the Editor, to see a list of its attributes.
  2. Click an attribute name to type in a value or to select from a list if the attribute takes pre-defined values.
  3. Click outside the current field to enter the new value in your code.

Every tag that HomeSite installs includes a definition file, written in VTML, that specifies the valid attributes for that tag and the content and formatting of the tag's editor.

Note To change a tag definition file:
  1. Click the Edit Tag Definitions icon to open the Tag Definitions Library dialog box. The left pane lists all of the installed languages. You can edit the definitions list by using the Add and Remove buttons.

  2. Expand a language entry to view individual tags. When you select a tag, the attributes and other components defined in its VTM file appear in the tabbed pane.
  3. Make changes in the tag definition fields and click Done to save the changes.

Scripting Event Handlers

Click on an event attribute, such as ONCLICK, for the selected tag and choose a script language option from the drop-down list. Enter a name for the event handler and click OK to insert the handler ID in the tag and a starter script block in the <HEAD> section.