194
Chapter 13 Extending the Help System
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
tree. For most users, this is all you need to do.
If, however, you want to control the order in which the Help references appear, you
can edit the booktree.xml file in the Help root directory. The structure of the booktree
file uses a basic tag set to configure how the Help displays on the book, chapter, and
page levels.
The parser reads the booktree tags from top to bottom, so you can 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. Alternatively, you can use the path attribute in the
book and chapter tags to specify the folder's location on your computer.
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 HomeSite, open the new Help folder.
3
In the file list, double-click the booktree.xml file.
The booktree file opens in the Editor.
4
Add a book tag for the new folder and save the file.
Example:
<help_book path="folder name">Custom Help Files
The new folder appears in the order that you set, 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 rearrange them.
Summary of Contents for HOMESITE
Page 11: ...Contents xi Table of CommandID values 310 Table of SettingID values 314 Glossary 323...
Page 12: ...xii Contents...
Page 20: ...xx About This Book...
Page 28: ...8 Chapter 1 Setting Up the Product...
Page 70: ...50 Chapter 4 Managing Files...
Page 88: ...68 Chapter 5 Writing Code and Web Content...
Page 116: ...96 Chapter 6 Editing Pages...
Page 148: ...128 Chapter 7 Using Web Development Languages...
Page 190: ...170 Chapter 11 Deploying Files...
Page 210: ...190 Chapter 12 Testing and Maintaining Web Pages...
Page 216: ...196 Chapter 13 Extending the Help System...
Page 350: ...330 Glossary...
Page 358: ...338 Index...
