Indexing with Indexer means assigning index terms as entries for each page. Cenral to this task is the list of index terms that can be assigned. This list is kept in the project directory as file indexterms.txt, as described in the Admin guide.
The project directory must have a file indexterms.txt. The format is described in the Admin Guide; it may be edited with any text-oriented editor. However, Indexer now offers TermsEditor for creating and revising indexterms.txt.
The TermsEditor window, at right, has, top-to-bottom, menu bar, the Find / Create line, the table of index terms, and a message line.
Typing into the Find/Create box causes the table to scroll to the term begining with the current string. Click the Add Term button to add a new main term with the name in the Find/Create box.
"Opening" a cell - When you click on a cell in one of the text columns, it "opens" for editing; a box surrounds it and the background is white. You can edit text in an open cell with all the usual text editing operations: mouse selection, text typing, backspace, and all the others. The cell is closed by typing enter or clicking elsewhere.
If a cell is selected, but not open, it can be opened by clicking or by typing F2.
Unscrolling - If the contents of a cell are changed, it is resorted to its new alphabetic location in the table. This often scrolls the table. To return to the previous scroll position, type alt-left arrow. (This same keystroke is used in browsers for going back to the previous page.)
Closing cells - An open cell can be closed by typing ENTER.
If a cell is open, and has changed in value, no other operation can be done until the cell is closed. Attempting another operation will close the cell, but not do the operation. To remind you that a cell has closed, every time a cell closes a small whoosh is sounded. So if you try to do an operation and hear a whosh, you will know the operation did not get done.
A number of special key strokes are defined.
Arrow keys - If no cell is open, the arrow keys will move the selection from one cell to the next. In an open cell the arrows move the cursor through the text.
ENTER - If a cell is open, ENTER will close it. If no cell is open, and a non-text (insert or delete) column is selected, the ENTER key will perform the insert or delete operation dictated by the column.
F2 - Open cell - If a cell is selected and not open, F2 will open it. (This is the same as in Excel.)
^Z - Undo - Same as the operation in the menu.
^Y - Redo - Same as the operation in the menu.
^N - Convert name - Same as the operation in the menu.
^S - Save - Same as the operation in the menu.
F1 - Help - Same as the operation in the menu. (Use the Browse User's Guide option in the Help menu to open this Guide.)
Typing accented characters
For an accented letter, hold the control key and type the prefix, release control and type the letter. Similarly for upper case. See the table to the right.
On US keyboards, quote is an upper case apostrophe, tilde is
an upper case grave, and circumflex is an upper case 6.
Here are the columns of the table.
4 Index Terms. A main term is unindented or ditto marks to repeated the term on the line above it. A subterm is indent and prefixed with a colon. A "referer" term is indented and surrounded with (^ and ). Referer terms are not available to be assigned as entries to pages. Instead, when the index is generated there will be an entry for the referer. Its contents will be "See" followed by the parent main term.
Click on an item in column 4 and it is opened for editing. If the text is revised, the term will be moved in the table to its proper alphabetic position.
A word about acronyms - If a main term has an acronym, as in
Gross State Product (GSP)
a referer from the acronym to the term is automatically generated. The acronym will not appear in the termslist window, but will appear in the generated index.
2 Trigger phrases. When a page is made "current", the background for its entries becomes yellow. At the same time the page text is scanned to see if it has any trigger phrases in terms newly defined since the page was last scanned. When a trigger phrase is found, the phrase in the text is colored. If the trigger applies to only one term, the phrase is colored blue and the term is added to the pages entries. If more than one term applies, the phrase is colored red, but no entries are added.
1 "Add phrase" arrow. Clicking an arrow in the left column causes an additional instance of the term to be added and its phjrase is opened to type in a phrase. (Until a phrase is typed in, the phrase internally has the value "~~~".)
3 "Add subterm arrow. Click an arrow in the third column and a new subterm line is added to the main term and opened for editing. (Until a subterm is entered, the subterm internally has the value "~~~".)
5 Clicking a red X in the fifth column will the term on that line. Main terms can only be deleted if they have no subterms.
Referers are added in column 4 with the AddReferer menu item. It is in the Edit menu in the menu bar and also on a popup. A referer line is added and opened for editing. (Until a referer is entered, it internally has the value "~~~".)
In the screen shots, one letter is underlined in each row. This is the menu item's "mnemonic key". Typing that key while the menu is visible will perform that menu item.
indexterms.txt. (This will be done automatically when switching back to Indexer.)
Saves the terms to
Prompts for the name of a .txt file and scans it for proper nouns, adding those found to the terms table. See
Prompts for the name of a file with one name per line and addds the names to the terms table. See
Saves the terms list and closes the Indexer and TermsEditor applications.
Reverses the effect of the last operation. The xxx names the sort of operation. Major operations like and canot be undone.
If an operation has been unone, this operation does it again. A single operatno can be Undo-ed and Redo-ed any number of times, but the number of saved operations is no more than 25.
The current row is deleted. Terms canot be deleted until all subterms and referers have been deleted.
A new row is inserted for the term on the current line. The phrase column is blank and opened for editing.
A new row is inserted below the current line. The term field is opened as a subterm (with a leading colon.)
A enw row is inserted below the current row and its term field is opened as a referrer, inside (^ and ).
The term field is modified as though it were a name in form first-middle-last. The new version is in form last-comma-first-middle.That is, the last full word is moved to the front and a comma is placed after it. Typing control-N has the same effect.
Opens the Context Help window. As you move the mouse over the Terms Editor window, the Context Help window is scrolled to a description of the item under the mouse. To scroll in the Concext Help window, type the F1 key; it jumps the mouse to the Context Help window with out intervening mouse motion. Then you can scroll within the Context Help window to read descriptions.
Opens your local browser showing your local copy of the Indexer User's Guide. (If the local copy downloaded with InstallIndexer is not available, the website copy will be shown.)
Displays a small dialog box with the Indexer versino number, the current directory, and the current file.
Clicking the indexterms.txt. The terms are also scaned for consistency; redundant terms are deleted and necessary terms are added. Examples of necessary terms include the main term for a subterm or a mnemonic. The design of the TermsEditor makes it unlikely that any such modifications are needed.
button closes the table and returns to viewing pages and their index entries. At this time, the index terms are written to their file,