Navigating a document structure in the Tag Tree

The Tag Tree is located in the top pane of the Tag Inspector tab of the Resources window. It is helpful for inspecting and navigating a document's structure. You can easily configure it to display just the tag sets you want.

You can edit all of the code in a document without needing to work directly in the editor, by using the Tag Tree and Tag Inspector together. For information about Tag Inspector, see "Editing code in the Tag Inspector".

To use the Tag Tree:

  1. Open the drop-down list at the top of the pane to select an outline profile.

    For more information, see "About outline profiles".

  2. Click a tag in the tree to quickly locate it in the document. Press Shift+Ctrl and double-click to select the entire tag block.

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

  3. To update the Tag Tree as you edit the document, click the Refresh button on the Tag Tree toolbar.
  4. To display the contents of the selected tag in a single node on the Tag Tree, click the Collapse button on the Tag Tree toolbar.


The tag body must be collapsed in the Tag Tree to collapse it in the document.

About outline profiles

Outline profiles let you restrict the Tag Tree display to specific tag sets. Outline profiles are written in the Visual Tools Markup Language (VTML) and are saved in the \Extensions\Outline Profiles folder.

The default set of outline profiles gives you a lot of options for filtering the Tag Tree display, but you can easily customize profiles.

To create or customize an outline profile:

  1. In the editor, open an outline profile in \Extensions\Outline Profiles folder and examine its syntax. They are written in the Visual Tools Markup Language (VTML). The VTML markup identifies the tags that are recognized in the profile.
  2. If you are editing an outline profile, make a backup copy of the .vtm file.
  3. Edit the outline profile or, to create a new outline profile, save the file with a new name and then make changes to it.


If you prefer to work in a graphical user interface, display the Tag Inspector Resource tab and click the Configure Outline Profiles toolbutton in the top pane. The Outline Profile Editor dialog box appears, in which you can create and edit outline profiles.

Configuring the Tag Tree display

This section describes how to change the list of outline profiles in the Tag Tree, how to import an outline profile (.vtm) file, and how to import an outline profile from a .dtd file.

To modify the list of outline profiles:

  1. Click the Configure Outline Profiles button at the top of the Tag Tree pane.
  2. In the Outline Profiles dialog box, use the Add and Remove buttons beside the list of outline profiles to add and remove outline profiles.
  3. Under Recognized Tags, use the Add Tag and Remove buttons to edit the tag list for the selected outline profile.
  4. In the Tag Settings pane, you can add a caption and tool button to a tag.
  5. Click Done.

The outline profiles are updated for the Tag Tree.

You can import an outline profile from a Visual Tools Markup Language (VTML) file, or from a Document Type Definition (using the DTD file extension) from an SSL-compliant language, such as Extensible Markup Language (XML).

To import an outline profile:

  1. Click the Configure Outline Profiles button at the top of the Tag Tree pane to open the Outline Profiles dialog box.
  2. Click the Import button in the Configure Outline Profiles dialog box.
  3. Select either a VTML definition file or a DTD file to import.

    The Import from a DTD file option parses the selected file and stores the document information in a VTML file in the /Extensions/Outline Profiles folder.

  4. Browse to the .vtm or .dtd file that you need to import.
  5. Click Next.

    The Wizard reports the status of the import process.

  6. If the process completes successfully, click Finish.

To work with imported DTD information:

  1. Open the Tag Inspector.
  2. Select DTD Elements and Entities from the drop-down list at the top of the Tag Tree pane.
  3. Open a document that adheres to a DTD that you have imported.

    If you have imported multiple DTDs, the correct VTML information file is accessed automatically.

  4. Select entities and elements in the Tag Tree to highlight them in the document.