How the Server Side Search is Setup

Following is a description on how we used this functionality to build our full text search.

All the files for our default setup are distributed in the Data\Templates\CGI FTS\ folder. These files should be installed on a central location if you are using a multi-user edition of Author-it.

1. Specify the html_frameset.htm custom frameset in the HTML Frameset property on the HTML tab of the Book object. This frameset has 3 frames.
   • TAB frame - appears in the top left and displays the tabs. By default it displays tab_toc.htm. This HTML page contains several graphics with links to display the indexpage.htm and the search window.
   • TOC frame - appears in the bottom left and displays the Contents, Index and Search pages. By default toc.htm is displayed. Author-it always names the first TOC page toc.htm.
   • BODY frame - appears on the right and displays the main document. As the filename of the first page in a document is unknown, the default in the frame is a placeholder called main.htm. When publishing Author-it will rename this to the first HTML page in the document, whatever that may be.
2. In the HTML Additional Files property of the Book object we specify all the support files required. In this case:
   • tab_toc.htm - displays the Contents tab as active in the TAB frame.
   • tab_index.htm - displays the Index tab as active in the TAB frame.
   • tab_search.htm - displays the Search tab as active in the TAB frame.
   • contents1.gif, contents2.gif, contents3.gif - the 3 different states of the Contents button.
   • index1.gif, index2.gif, index3.gif - the 3 different states of the Index button.
   • search1.gif, search2.gif, search3.gif - the 3 different states of the Search button.
   • tail.gif - an 'invisible' image that completes the TAB frame
3. In the Table of Contents object we set the TOC Plain HTML Contents Display property in the HTML tab to use the frameset defined in the Book object.
4. In the Media object used by the Table of Contents object (usually Contents Section) we set the new HTML Template property in the HTML tab to use the toc_template.htm custom page template. In this page, some JavaScript executes in the onLoad event that loads the tab_toc.htm file in the TAB frame. This keeps the tab appearance synchronized with the Contents no matter where the Contents is called from.
5. In the Media object used by the Index object (usually Index Section) we set the new HTML Template property in the HTML tab to use the index_template.htm custom page template. In this page some JavaScript executes in the onLoad event that loads the tab_index.htm file in the TAB frame. This keeps the tab appearance synchronized with the Index no matter where the Index is called from.