Other (non SAS) Tools

This section of the manual contains operating information about the other tools, included with EZRTools, that work with languages other than SAS.

This macro will scan html files for named anchors. It uses these anchors to create an alphabetic index of HREF anchors, referred to as "thumb tabs". These allow the user to quickly jump to the start of an alphabetic section. The macro does not create entries in the thumb tab when no index items for that letter exist. The index (Indxlist.html) is placed in the larger frame of a frame set (vertical or horizontal split) and the thumb tabs (Indxjump.html) is placed in the other frame. Indxmain.html is the file that holds the frame set. Note: each time you run the macro, it will delete the old index files and recreate them.

To run this macro you should use Macro-Run and type HTML^MakeIndx . You are prompted for the location to write the index files. You are then prompted for one or more directories to scan. The macro looks for file with the extension *.html or *.htm. It then scans through the files in for named anchors. Note: if multiple directories selected they must be either the directory holding the index, or a subdirectory of it.

You will also be prompted for a few other choices that effect how your index will look. You will be prompted to select wether your letter index to the main HREF index will be located to the left of index or on top. You are also asked if you want to enter the <FRAMESET> or <FRAME> editor.

The macro will sort all the named anchors in alphabetic order based on the text surrounded by the anchor. This text also becomes the displayed phrase in the index. For each change in the first character of the index phrase a larger heading is made with the letter. The letter is contained in a heading tag. The heading is inserted above the changing index phrase. A corresponding link is made in the indxjump file (thumb tab) so the user may quickly skip to a point in the index. When you attach the generated index to your document you should point an anchor to Indxmain file. Keep in mind all the HREF locations in the index are relative to the directory where the index files was written.

If the following named anchor was found in a scanned file named Bob.html:

  ...
  This is a <A NAME="thislink">a Great Link</A> to go to
  ...
  

The following link would be added into the index file:

  <A HREF="Bob.html#thislink" TARGET="_top">a Great Link</A><P>
  

This example assumes that Bob.html is in the same directory as the index file. If it was in a subdirectory, that relative directory path would be appended in front of Bob.html in the HREF parameter of the index entry. The TARGET parameter is set to Display assuming that you have named your main viewing frame Display. If you have named it differently you can do a mass replace on TARGET="_top" and change it to the correct name. If you want the document to display in the same browser window change Display to _self