Instructions for Installing and Running the
"Tags" Macro
Version 2.0 Release
by Alan W. Gomes, Ph.D.
Talbot School of Theology
November 3, 1995
Description of the "Tags" Macro
The "tags" macro allows you to use a Microsoft Word file containing research notes as a kind of text database. The information in the file does not have to be formatted in any particular way, other than marking the beginning of each entry with a descriptive or numbered "tag," and designating the end of the entry with a page break. (The procedure for delimiting "card file" entries is discussed below.) When run, the macro will prompt you for a tag name/number, which the macro will use to extract the desired entries from your file of notes. Entries matching the tag will be copied and placed in a new file. In other words, the macro creates a smaller file which is a subset of your complete notes file; the subset file contains only the portion of your larger file that matches the value of the tag. For example, if you have a large file containing many sermon illustrations, you could have the tags macro go through and extract only those quotations dealing with justification by faith.
Installing the Tags Macro
Microsoft Word 6.0 stores macros in templates. The tags macro is stored in a template named "TAGS.DOT" (included). The macro in this template is compatible both with the Windows and with the Macintosh versions of Word 6.0.
To install the macro, you will use the style "organizer" to copy the TAGS macro from the TAGS.DOT template to your NORMAL.DOT (Windows) or NORMAL (Macintosh) template. Macros located in the NORMAL template are available for use in all documents all of the time.
To install the macro, follow these steps:
Adding the Tags Macro as a Menu Selection (Optional)
Microsoft Word 6.0 allows you to make macros available as commands that you can select from one of its menus at the top of the screen. By installing a macro as a regular menu command, you can have ready access to the Tags macro; you can run it simply by pulling down the appropriate menu and selecting the Tags command, just as you would select any other Word option or command. Note that it is not necessary to install the macro in this way; you can still run it from the "Tools|Macro" menu. However, if you plan to use this macro often, I recommend that you make it a permanent menu option.
I suggest that you add the Tags macro to your "Tools" menu. To do so, perform the following steps:
Setting up "Card File" Entries
The tags macro expects to see entries delimited by a hard page break. (A "hard page break" is a page break that you manually insert, as opposed to a "soft" page break, which occurs as the text you type naturally flows from the bottom of one page to the top of the next.) In other words, an entry (i.e., a record) consists of all the text between at the page break at the top of the first page of an entry up to the next hard page break; the entry is all the text between these hard page break boundaries. In Microsoft Word 6.0, a hard page break may inserted in one of two ways: (1) From the "Insert" menu on the menu bar at the top of the screen, select "Break," and then select "Page break." (2) Press "control-enter" (under Windows) or "Apple key-enter" (Macintosh).
Tags should be listed on the first line or lines of each card file entry. Without the tag, the macro would not have any way of determining whether to select the entry. Note that you may have multiple tags for any particular entry. A sample entry might be as follows:
[The entry begins with a hard page break...]
[15]--Anglo-Israelism in the Worldwide Church
[12]--Lost "truths" supposedly restored by Armstrong
Herbert W. Armstrong considered the identity of the Israelite people to be of utmost importance. He claimed that one of the eighteen great truths God restored through his ministry was that the United States, Britain and the nations of Europe are the descendants of the Lost Ten Tribes of Israel.
[The entry ends with a hard page break...]
[Next entry begins here...]
Now, you may be wondering why I have both a descriptive label and a number in square brackets as part of the tag. Actually, the macro will work fine with the descriptive label alone or the number alone. In practice, I have found it best to use a unique number in square brackets for each topic and then have the tags macro pull up the entry based on it. The descriptive label is added simply to aid readability as you are reading through your notes file. There are several reasons for using both a unique number and a plain English description:
Running the "Tags" Macro
Before running the TAGS macro, you must close all windows besides the window containing the notes file you wish to search. Then create a new, blank file in a new window. If you have too many or too few windows opened, the macro will put up and error message and ask you to set the appropriate number of windows before trying again.
Switch to your master notes file and then run the macro. When the macro runs, the entries selected from your master notes file will fill up the blank file. Note that once the macro has finished its work, the newly created file must be given a name and saved if you wish to retain permanently the information contained in it. Your original, master notes file is left unchanged.
The macro will also work if the file you have opened in the other window is not blank. In that case, the entries selected from your master notes file will be added to the other file.
Again, it is important that the master notes file is the currently displayed window before executing the macro. You need not worry about scrolling to the top of the file before running the macro: the macro will automatically position the cursor to the top of the file to insure that all entries are searched.
If you added the macro to your "Tools" menu (see above), you may run it simply by selecting "Tools" and then "Tags." If you have not added the macro to your Tools menu, then to run the macro you must select the "Tools" menu and choose "Macro." You will see a list of available macros. Select "TAGS" and then select "Run" to run the macro. The macro will prompt you to enter the desired tag. After entering the desired information, press "OK" and it will begin its work. When the macro has finished, it will beep and notify you that it is through.
Let me know how you like it.
Regards,
Alan Gomes