MACROMEDIA ColdFusion Server 5, Руководство пользователя

Страница: 58 / 328

40 Chapter 3 Exploring the Workspace
To add documents to the Help tree, do one of the following:
•
Write an HTML Help file and save it to a folder in the Help directory
•
Use standard Windows commands to paste a file into a Help folder
•
Display the document to add in a Web browser and then choose the Save As
command to save it to a folder in the Help directory
Changing the order of items in the Help tree
If you add a folder to the Help directory, the folder appears at the bottom of the Help
reference tree. For most users, this is all you need.
If, however, you want to control the order in which the Help References display, you
can edit the booktree.xml file in the Help root directory. The structure of the booktree
file uses a simple tag set to configure how the Help displays on the book, chapter, and
page levels. 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 tree. You can edit
this file to rearrange existing Help content as well as to add custom folders and files
to a specific location in the Help tree. Alternately, you can use the
path
attribute in
the book and chapter tags to specify the folder’s location on your system.
To add a folder to a specific location in the Help tree:
1 In Windows Explorer, open the Help root directory, make a backup copy of the
booktree.xml file, and copy the new folder into the Help root directory.
2 In the product, open the new Help folder from the Files resource pane.
3 Open the booktree.xml file in the Editor.
4 Add a book tag for the new folder and save the file.
Following is an 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 appear
in alphabetical order. If you want to control the order of chapters and pages, add tags
in the booktree file for these entries and arrange them to be in your desired order.
Displaying text files in the Help tree
Text files can be added to the Help reference tree. The Help browser default file type
is HTML, so it looks for a
TITLE
tag in each file. If it does not find one, or if the tag is
empty, it displays the filename as the document’s title in the Help tree.
To change an HTML file’s title in the Help tree, edit the HTML file to complete its
<title>
tag with the desired name.
To change a text file’s title in the Help tree, first make a backup copy of the
booktree.xml file in the Help root folder of your installation directory. Then open
booktree.xml in the editor, find the
<help_page>
tag for the text file, and add a
title
attribute for the text file; for example, <help_page title="My Readme">.