MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION..., Руководство пользователя

Страница: 25 / 236

Exploring the Workspace 25
Adding Help References to the booktree structure
If you add a folder to the Help directory, the folder appears at the bottom of the Help
References list. For most users, this is all you need.
If, however, you want to control the display order of the Help References, you can edit
the booktree.xml file in the Help root directory. The booktree structure uses a simple
tag set to configure the Help display on the book, chapter, and page level. A quick study
of the file will get you started.
The parser reads the booktree tags from top to bottom, so you can just insert folder
and file tags where you want the references to appear in the Help list. This applies to
rearranging existing Help content and to adding new files. Alternately, you can use the
path attribute in the book and chapter tags to specify the folder location.
To add a folder to the Help structure:
1. Copy the new folder into the Help root directory.
2. Open the Help directory from the Files tab.
3. Make a backup copy of the booktree.xml file.
4. Open the booktree.xml file in the Editor.
5. Enter a book tag for the new folder.
Example: <help_book path="folder name">Custom Help Files.
The new folder now appears in the order you set up, but the files in the folder will be
displayed in alphabetical order. If you want to control the display at the chapter and
page level, you can tag these entries in the booktree file.
Displaying text files in the Help structure
Text files can be added to the Help tree. The Help browser default file type is HTML, so
it looks for a
TITLE
tag in each file. If it doesn’t find one or the tag is empty, it uses the
filename in the Help tree display. You can use the
<help_page title="">
attribute to
add title text, if you wish.