KwdList

KwdList, HTML Multi-File Keyword Adder

This application displays a selectable list of keywords in a window, and adds the selected keywords to one or more HTML files that are dragged and dropped onto the KwdList window from Windows Explorer.

To use this utility, perform the following steps:

  1. Invoke the application, supplying a keyword file as the command-line argument. A window will appear with the list of keywords from the keyword file. The window may be resized as needed.
  2. Invoke Windows Explorer and find the files you wish to modify.
  3. In the KwdList window, select the keywords that you wish to add.
  4. Drag the HTML file(s) you wish to modify from the Explorer window into the KwdList window. The selected keywords will be immediately added to the keyword lists of the dropped files.
  5. As an alternative, you can press the Copy button to copy the list of selected keywords to the clipboard as a text list.
  6. You can clear all selections by pressing the Clear button, and then repeating the steps starting at step 2 above for other files.
  7. When you no longer need the KwdList window, press the Close button.

This utility will only add keywords to the dropped files. To remove keywords, you most use the DropHTM utility.

Files other than HTML files may be dragged onto the window. When this happens, the HTML file with the same base name will be modified. If an HTML file with the same base name does not exist, one will be created.

File folders (directories) may also be dragged onto the window. When this happens, the corresponding index file which is contained in the directory is modified. An index file must be named "index.htm", "index.html", "welcome.htm", or "welcome.html". If an index file does not exist for the directory, one will be created with the name "index.htm".

If a single file is dropped onto the KwdList window when no keywords are selected, the keyword list is read from the dropped file, and the corresponding keywords in the window are automatically selected.

Context Help

If you right-click on a keyword in the list, a description of that keyword will be displayed if one is available in the keyword file.

Keyword Files

A keyword file is a file which contains a list of keywords and, optionally, their definitions. Keywords appear in the KwdList window in the same order as they appear in the keyword file.

Format 1: Simple List

A simple keyword file is a single list of keywords and optional definitions. The file must be in the following format:

keyword1 [tab description1]
keyword2 [tab description2]
keyword3 [tab description3]
keyword4 [tab description4]
keyword5 [tab description5]
...

Each line consists of a single keyword, optionally followed by one or more tab characters and a description of the keyword. Keywords must not be preceeded by spaces (must start at the beginning of the line). The description will appear when the keyword is right-clicked. The description may contain embedded newline characters in the form "\n".

Format 2: Outline

An outline keyword file is subdivided into one or more sections, each with a section heading. Section headings cannot be selected to appear in the keyword list, and are used only to make the list easier to read. The file must be in the following format:

Heading1
space keyword1 [tab description1]
space keyword2 [tab description2]
space keyword3 [tab description3]
...
Heading2
space keyword4 [tab description4]
space keyword5 [tab description5]
space keyword6 [tab description6]
...

Heading lines must not be preceeded by spaces (must start at the beginning of the line). Keyword lines must be preceeded by one or more spaces (indented), and will be displayed along with the preceeding space(s). Otherwise, they are the same as the Simple List.

Keyword Rules

Keyword rules provide a way to automatically select or deselect keywords based on other keywords. For example, you can make a rule that keyword "color" must appear in the keyword list if the keywords "red", "green", or "blue" are selected.

Keyword rules may appear anywhere in the keyword file. They do not appear in the KwdList window. Each rule must appear on its own line, begin with a '?' character in column 1, and follow the keyword rule syntax. All rules are evaluated each time a keyword in the list is selected or deselected. They are evaluated in the order in which they appear in the keyword list. Keywords that are added to the keyword list by a rule need not appear in the keyword file as a user-selectable keyword.

For example, you can use the following rule to make sure the keyword "color" is included in your list whenever "red", "blue", or "green" is selected:

   ?red|blue|green,+color

Keyword files must not contain blank lines.

Copyright © 1996-1999 Christopher P. LaRosa. All Rights Reserverd.