Troubleshooting
Problem: When you try to open the template to install the program, Microsoft Word tells you that “The macros in this project are disabled . . .”
Solution: Microsoft Word’s macro virus protection is enabled or set to a high level of security. To change this:
In Word 2002 (XP):
1. Click the “Tools” menu.
2. Click “Options”.
3. Click the “Security” tab.
4. Click the “Macro Security” button (on the lower right).
5. Click the “Security Level” tab if it’s not already active.
6. Set your security level to medium and click the OK button.
7. Click the next OK button to close the Options dialog.
In Word 2000 or 2001:
1. Click the “Tools” menu.
2. Click “Macro.”
3. Click “Security.”
4. Click the “Security Level” tab if it’s not already active.
5. Set your security level to medium and click the OK button.
In Word 97 or 98:
1. Click the “Tools” menu.
2. Click “Options”.
3. Click the “General” tab.
4. Uncheck the box labeled “Macro virus protection.”
5. Click the “OK” button.
In Word 95:
1. Click the “Tools” menu.
2. Click “Options.”
3. Click the “General” tab.
4. Uncheck the box labeled “Enable Macro Virus Protection.”
5. Click the “OK” button.
Now, in Word 2000 or higher, any time you open a document or template that includes macros, Word will give you the choice of whether to disable or enable macros. If the document or template isn’t supposed to have macros in it, you should click the “Disable Macros” button, because the macros could be a virus. If the document or template is supposed to have macros and comes from a source you know is reliable, click the “Enable Macros” button so you can run the macros.
In Word 95, 97, or 98, you don’t have these options. Macro virus protection is either on or off. Before turning it off permanently you may want to read more about it in Word’s Help file or check with your system administrator.
Problem: You’ve installed the program, but you can’t see or find the program menu. In addition, Word may have crashed after you finished the installation.
Solution: Delete any existing versions of the progam template that are in Word’s Startup and Templates folders. Then, to install the program, open the newly downloaded program template in Microsoft Word by clicking File > Open, selecting the template, and clicking the Open button. Do not open the template by double-clicking it outside of Microsoft Word. If you do, the program will not be installed correctly. After opening the template in the proper manner, follow the installation instructions in this documentation.
If you still have problems after this, once again delete any existing versions of the program template that are in Word’s Startup and Templates folders. Then simply copy the template into Word’s Startup folder and restart Microsoft Word.
If you don’t know the location of the Startup or Templates folder, you can find it like this:
1. Click the Tools menu.
2. Click the Options menu.
3. Click the File Locations tab.
4. Click the line that says “User Templates” or “Startup.”
5. Click the Modify button.
You’ll see the full path to your folder. Write it down. Click Cancel and then Close to put the dialog away.
Problem: When you try to load RazzmaTag as a global template or add-in, you get the Convert File dialog, asking you to select a kind of text for conversion.
Solution: You’re trying to load the wrong version of RazzmaTag for your version of Microsoft Word. To get the correct version, please download it from the Editorium at www.editorium.com.
Problem: When you try to load RazzmaTag as a global template or add-in, the status bar says, “Translating macros” and shows Word’s progress as it translates the macros in RazzmaTag.
Solution: You’re trying to load the wrong version of RazzmaTag for your version of Microsoft Word. To get the correct version, please download it from the Editorium at www.editorium.com.
Problem: RazzmaTag won’t work at all, even though you’ve loaded it as a global template.
Solution: Make sure you’ve set your macro security options to allow third-party macros to work. See your Word documentation for more information. You may also have this problem if you’re working on documents that have been created in other word-processing programs, such as WordPerfect, and then opened into Microsoft Word. If that’s the case, you may be able to save the documents from the other program into Microsoft Word format before opening them into Word. You may also need to use a dedicated document-conversion program.
Problem: You’re tagging documents and saving as text, but RazzmaTag keeps saying that you appear to be untagging documents and asking if you really want to save as text. What’s going on?
Solution: Somewhere in your master list is an incorrect RazzmaTag code. For example, the code for tagging a paragraph style is +P. But your list may have +p (lowercased) somewhere instead.
If you’re purposely tagging and untagging at the same time (which is possible but not recommended), you’ll also see this warning.
Problem: You’re untagging files and saving as Word documents, but RazzmaTag keeps saying that you appear to be tagging documents and asking if you really want to save as Word documents.
Solution: Somewhere in your master list is an incorrect RazzmaTag code. For example, the code for untagging a paragraph style is +p. But your list may have +P (uppercased) somewhere instead.
If you’re purposely tagging and untagging at the same time (which is possible but not recommended), you’ll also see this warning.
Problem: You just untagged a document, and now it’s full of red and blue formatting.
Solution: If you’re untagging a text file, your custom paragraph and character styles won’t even exist in the document (since it’s a text file). So how is RazzmaTag supposed to replace your tags with your custom styles? There’s only one way it can—by creating those styles. Of course, RazzmaTag has no idea how those styles should be formatted, so it formats paragraph styles as red and character styles as blue, just so you can spot the newly formatted text easily. Next, of course, you’ll want to modify the styles or apply a different template to the document (being sure to update styles) so the formatting will look the way you want it to.
Problem: You want to tag or untag documents, but they’re just not turning out right. The formatting is wrong, or the tags are messed up.
Solution: If you start having trouble with stuff like this, slow down. Don’t panic and wildly start trying to fix entries on your list. Instead, try processing your entries one at a time, or better yet, try searching for an entry manually in Word so you can see what’s actually happening. For example, if you have an entry like this on your master list—
Heading 1|<Chapter Title>+P
—you can try doing the same thing manually to see what that entry does. In this case, after clicking Edit > Replace, you’d select the style formatting for Heading 1 in the “Find What” box, otherwise leaving the box empty. (You may need to click the “More” button before this option is available.) (Make sure you don’t type “Heading 1” into the box. You’re trying to find formatting, not the words “Heading 1.”) Then, in the “Replace With” box, enter the text “<Chapter Title>” (without the quotation marks) and select the format of Normal style. Click the Find button to find the first instance of Heading 1 formatting in your document. Then click the Replace button to make the change. Now look at the change in your document. Is it what you wanted? If not, you’ll need to adjust your entry.
Here’s an example of untagging:
\<Chapter Title\>(*)|Heading 1+p
In this case, you’d put “\<Chapter Title\>” in the “Find What” box. Then you’d format the “Replace With” box as Heading 1. Next, put “\1” in the “Replace With” box, telling Word to replace the text “\<Chapter Title\>” with the text found by (*) which would be no text at all. Finally, put a check in the box labeled “Use Wildcards” or “Use Pattern Matching.” Then click the Find button and the Replace button to see what’s going on. (For more information about these arcane symbols and how they work, see the document “Advanced Searching in Microsoft Word” that came with RazzmaTag.)
With this kind of line-by-line experimentation, you’ll soon learn what’s causing the problem.
Problem: RazzmaTag isn’t making some of the changes you specified.
Solution: RazzmaTag can’t make any changes you couldn’t make manually with Word’s Find and Replace features. Please read “Using Word’s Find Options” in this documentation for more information. Also, some documents originally created in WordPerfect don’t work well with Find and Replace in Microsoft Word. You can check this yourself by trying the Find and Replace manually. Finally, you may have forgotten to add the codes at the ends of your master-list entries. Those codes are:
+P = tag paragraph style formatting
+A = tag character style formatting
+F = tag character formatting (such as bold or italic)
+p = untag paragraph style formatting
+a = untag character style formatting
+f = untag character formatting (such as bold or italic)
Without the codes, RazzmaTag won’t know what to do and will essentially ignore your entries.
Problem: RazzmaTag has been running for hours while working on just a few short documents.
Solution: Press the Escape key to stop the program. Look at the cursor position in the open document to see if you can figure out what may be causing the problem. If you can, fix the problem before running RazzmaTag again. Also, check the documents after the problem document to see if they have the same problem. If you’ve used revision marking in the document, you may need to make revisions permanent before proceeding. You may also have problems if you’re working on documents that have been created in other word-processing programs, such as WordPerfect, and then opened into Microsoft Word. If that’s the case, you may be able to save the documents from the other program into Microsoft Word format before opening them into Word. You may also need to use a dedicated document-conversion program.
Problem: You get an error message while running RazzmaTag.
Solution: You may be trying to work on a document that is read-only, password-protected, or needs to be converted from another word-processing format. Try opening the document into Word without using RazzmaTag. If you get an error message, you’ll need to fix the document or problem before using RazzmaTag. Also, make sure all of Word’s import filters have been installed. Otherwise, Word won’t be able to open documents from other word processors and will give you an error message if you try to open them, with or without RazzmaTag.
Problem: Microsoft Word crashes at some point when you’re using RazzmaTag.
Solution: Some of your documents may be corrupt. You can identify a document that caused the crash by reading its name in the bar at the top of the Word window when the program crashes. If possible, open the document, copy all of its text but the final paragraph mark, and paste the text into a new document.