TWO ALTERNATE INSTALLATION OPTIONS ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Clicking the red button in the ANT_INST.DOC file is easy and harmless but just opening the file causes scary warning messages on some systems. The README.TXT file contains more info about this. Here are a couple of optional installation methods that you can use INSTEAD OF using the automatic procedure offered in the ANT_INST.DOC file. These methods aren't as painless as just clicking the red button in the ANT_INST.DOC file, but they'll accomplish the same thing without having to go through seeing the horrid, scary Warning Messages that Microsoft has built into some MAC and WIN95 systems when the ANT_INST.DOC file is merely opened in MS Word. Regardless of which of the following options you choose... 1. Copy the ANT_DEMO.DOT file to whatever directory you use to store your Word template (.DOT) files. (Usually it's the WINWORD/TEMPLATE directory.) If you're not certain... Look in your WINWORD6.INI file (WINDOWS directory) There will be an entry for your USER-DOT-PATH which reads: "USER-DOT-PATH=C:\WINWORD\TEMPLATE" or "USER-DOT-PATH=D:\MSOFFICE\TEMPLATE" or "USER-DOT-PATH=" + something This is where your .DOT files (Template files) are stored. 2. Copy the ANTDEMO.HTM file into the same directory. (You can delete this file later if you want. This is the example HTML file that the HTML to WYSIWYG Tool uses to demonstrate the conversion from HTML to .DOC.) 3. Create the "ANT_HTML.INI" file. (This is the file that the program uses to keep track of where things are and to record your preferences when you use the tools which record those preferences.) Take a deep breath. (This is the part the ANT_INST.DOC red button makes painless and since you've opted not to click the red button, here are the alternative options.) The ANT_HTML.INI file is a simple text file, named "ANT_HTML.INI" and should be placed in your WINDOWS directory. The file can be created with any simple text editor, like Windows Notepad or Wordpad. (It shouldn't be created with a wordprocessor like MS Word, though, because wordprocessors will add funny (and not so funny) codes and bungle up the works. If you MUST use a wordprocessor, be sure to save the file in TEXT ONLY format.) All .INI files are basically simple text only files and most of them contain a lot of text. The ANT_HTML.INI only requires eight lines of text. (Other entries will be added later, but they'll be added automatically. You won't have to do anything or change anything.) ----- Example of content of ANT_HTML.INI FILE ------- [LocalizedStyleNames] LocalVersion=English (US) Normal=Normal Title=Title Heading=Heading Platform=Windows 3.10 TemplatePath=c:\winword\template PathDivider=\ ----- End of Example of content of ANT_HTML.INI FILE ------- After you've created a blank text file and have named it "ANT_HTML.INI" and placed it into your WINDOWS directory... ```````````````````````````````````````````````````````````````````` MANUAL CREATION OF THE ANT_HTML.INI FILE OPTION A: 1. Copy and paste the following into the ANT_HTML.INI file: (Top of the file will be fine. It's okay to have a blank line first, if you want.) -------Copy and paste text below------- [LocalizedStyleNames] LocalVersion= Normal= Title= Heading= Platform= TemplatePath= PathDivider= -------Copy and paste text above------- Then... 2. Type the language version of Word you're using after the equal sign of the "Local Version=" entry. If you're not sure, click the Tools, Language in WORD and see which language version is highlighted.) 3. For the "Normal=", "Title=", and "Heading=" entries, enter "Normal", "Title", and "Heading" if you're using an English language version of WORD. If you're using a German, French, Spanich, Hebrew or other international-language version of WORD, enter the names of the Styles that are the equivalent of the "Normal", "Title", and "Heading" WORD Styles immediately after the "=" character. 4. The "Platform=" entry should be "Platform=Windows 3.10" or the equivalent which indicates which environment and version number you have. I regret to report that there's no simple way (other than the one used in the ANT_INST.DOC file) to get the information if you don't already know what it is. 5. The "TemplatePath=" entry can be found in your WINWORD6.INI file (WINDOWS directory). Open your WINWORD6.INI file and look for the entry which reads "USER-DOT-PATH=" (+ your path). It will look something like this: "USER-DOT-PATH=C:\WINWORD\TEMPLATE" (without the quotation marks). Copy and paste the path portion after the equal sign in the "TemplatePath=" entry of your ANT_HTML.INI file (without any quotation marks). If the very end of the path contains a ":" or a "\" character, delete it from the entry in the ANT_HTML.INI file. (DO NOT DELETE OR CHANGE ANYTHING IN YOUR WINWORD6.INI FILE.) 6. The "PathDivider=" entry is the relatively easy. After the equal sign... If you're using a Macintosh computer, type ":" If you're NOT using a Macintosh computer, type "\" No matter what sort of computer you're using, don't type the quotation marks. Just type a colon or a backslash. 7. That should do it. Now, save the ANT_HTML.INI file and close it. (There'll be no need to bother about the ANT_HTML.INI file again. Might be a good idea to save a copy of it in a different location, just in case it accidentally is deleted.) To run the program, just... Open Word Select File, New When the dialog box asks you which template you want to base your document on, select the Ant template. Click OK. Two of the Ant's four toolbars should immediately appear and you can begin creating an HTML document. `````````````````````````````````````````````````````````````````````````````````` OPTION B: Create Your Own Macro to Read the Paths This option may or may not produce some of the horrid, scary messages. However, since all that's happening is that the macro is READING and NOT CHANGING the paths AND you can look up the commands to verify that this is the TRUTH of the matter, it's an alternative to consider if OPTION A, described above, seems a terrible pain. If you have no experience writing macros, this might be helpful for future macro writing. 1. Open Word 2. If a new, blank document based on your regular "NORMAL.DOT" template doesn't automatically appear, select FILE, NEW and click OK so a blank document based on NORMAL.DOT appears. 3. Select the Tools Menu, then Macro. 4. In the Macro Name Box, type a name without any spaces. "ApplicationInfo" will be fine. 5. The "Create" button will become accessible as you type the name of the macro. Click the Create Button. 6. A "Macro Window" will open and the words: "Sub MAIN" will appear at the top, there's an empty paragraph mark and then the words: "End Sub" appear at the bottom. 7. Delete everything in the Macro Window and copy and paste the following macro code instead: DO NOT add paragraph marks, spaces or ANYTHING to the macro. Just copy and paste all the text, starting with the words "Sub Main" through the words "End Sub" into the Macro Window. '------------- Copy and Paste the Text Below ----------------- Sub MAIN On Error Goto ErrorTrap Insert "[LocalizedStyleNames]" + Chr$(13) LocalVersion$ = AppInfo$(16) Msg$ = "Local Version is: " + LocalVersion$ MsgBox Msg$, "Local Version", 64 Insert "LocalVersion=" + LocalVersion$ + Chr$(13) nsMsg$ = "If you're using an English language version of Word," + \ "just click OK. If not, enter the equivalent of Normal Style." nstyle$ = InputBox$(nsMsg$, "Equivalent of NORMAL Style ") If nstyle$ <> "" Then Insert "Normal=" + nstyle$ + Chr$(13) Else Insert "Normal=Normal" + Chr$(13) End If tsMsg$ = "If you're using an English language version of Word," + \ "just click OK. If not, enter the equivalent of Title Style" tstyle$ = InputBox$(tsMsg$, " Equivalent of TITLE Style ") If tstyle$ <> "" Then Insert "Title=" + tstyle$ + Chr$(13) Else Insert "Title=Title" + Chr$(13) End If hsMsg$ = "If you're using an English language version of Word," + \ "just click OK. If not, enter the equivalent of Heading Style." hstyle$ = InputBox$(hsMsg$, " Equivalent of HEADING Style ") If hstyle$ <> "" Then Insert "Heading=" + hstyle$ + Chr$(13) Else Insert "Heading=Heading" + Chr$(13) End If Platform$ = AppInfo$(1) PMsg$ = "Platform is: " + Platform$ MsgBox PMsg$, "Platform", 64 If InStr(Platform$, "Macintosh") Then PathDiv$ = ":" Else PathDiv$ = "\" Insert "Platform=" + Platform$ + Chr$(13) DOTPath$ = DefaultDir$(2) dpMsg$ = "USER-DOT-PATH is: " + DOTPATH$ + Chr$(13) + Chr$(13) + \ "Is the LAST character in the DOT PATH on the line above " + \ "one of these two characters: " + Chr$(34) + " : " + Chr$(34) + \ " or " + Chr$(34) + " \ " + Chr$(34) + \ Chr$(13) + "[Either a colon or a backslash] ?" dp = MsgBox(dpMsg$, "Last Character in the DOT PATH", 292) Insert "TemplatePath=" + DOTPath$ If dp = - 1 Then CharLeft(1, 1) EditCut Insert Chr$(13) Else Insert Chr$(13) End If PDMsg$ = "Path Divider is: " + PathDiv$ MsgBox PDMsg$, "Path Divider", 64 Insert "PathDivider=" + PathDiv$ FinalMsg$ = "Okay, All Done" MsgBox FinalMsg$, "The Macro is Finished", 64 ErrorTrap: If Err = 102 Then Goto Finish Err = 0 Finish: End Sub '------------- Copy and Paste the Text Above ----------------- 8. Click File, Save and close the Macro Window. 9. Click Tools, Macro, then the name of the macro you just created, then click "RUN". 10. The paths (and answers to most of the questions which belong after the equal signs in the ANT_HTML.INI file) will be entered into the blank document and also presented to you in the form of Word Message Boxes. Several of the Message Boxes will ask you questions. Three questions relate to Word Style Names. If you're using an English language version (U.S., British, Australian versions included), just click OK when the question appears. If you're using a German, French, Spanish, Hebrew or other language version of Word, please enter the Word Style Names which are the equivalent of "Normal", "Title" and "Heading" styles in the dialog box and then click OK. 12. When the macro has finished, copy and paste the contents of the document, you have two choices... a. Copy and paste the contents into the ANT_HTML.INI file or b. Save the file with the name "ANT_HTML.INI" and make certain to select the "TEXT ONLY" setting in the "Save File As Type" section (at the bottom of the File Save Dialog Box). The file should reside (or copied) to your WINDOWS directory. Make sure it's there. Okay, that should do it for OPTION B. To run the program, just... Open Word Select File, New When the dialog box asks you which template you want to base your document on, select the Ant template. Click OK. Two of the Ant's four toolbars should immediately appear and you can begin creating an HTML document. ------------------------------------------------------------------------ If something is amiss, it might be an uppercase/lowercase problem. Duplicate the case in the example that appears at the top of this page. If you think it's ridiculous that Microsoft creates horrid, scary messages when a macro merely reads directory and system information, you're not alone. If you get peeved about it, I know how you feel. If you feel you must write to someone to complain about it, you know who to write. :) ````````````````````````````````````````````````````````````````````` The ATTACH ANT TEMPLATE Tool This is entirely optional and if you choose to add the tool, it's a convenience, and does not affect the operation of the program. If you want to add the "Attach Ant Template" Tool to your Standard Toolbar, you just use the usual Word methods. (The description of the tool can be found in the "ANT.HTM" file. View it in any Web browser.) Here are the steps: 1. Open Word 2. Select File, New 3. When the dialog box asks you which template you want to base your document on, select the Ant template. 4. Click OK. 5. Choose Tools, Macro, Organizer 6. From the ANT's list of macros (on the left), select Attach ANT Template. 7. Make sure the NORMAL.DOT list of macros is on the right and Choose Copy 8. Choose Close You may then create a toolbar tool for the macro if you wish. (Use the usual Word method...) 1. Select View, Toolbars, Customize 2. In the Categories Box, choose Macros 3. When the list of macros appears, select the Attach Ant Template macro 4. Hold the left mouse button down and drag the Attach Ant Template macro to your Standard toolbar. (Usually the topmost toolbar.) 5. Choose a toolbar button face and click Assign or create one of your own by clicking Edit 6. Choose Close Okay, it's done. Now, whenever you open Word, the button will be there, ready to start the Ant program quickly for you. You can delete the macro and the toolbar tool whenever you like. To quickly delete macros and toolbar tools: 1. In Word for Windows: Hold down the ALT key and drag the tool off the toolbar. In Word for Macintosh, from the Tools Menu, choose Customize and then select the Toolbars tab, then drag the tool from the Toolbar. 2. In the Tools Menu, choose Macro, then click on the "Attach Ant Template" entry (or whatever macro you want to delete) and press the DELETE key.