Installation of Syntax Coloring Parsers

These instructions ask you to modify the Windows registry. If you are uncomfortable doing so, we would recommend not installing this parser.

Replace the * with the name of the parser you downloaded.

1. Extract the file '*.scc' from *.zip.

2. Copy the file '*.scc' to the Parsers subdirectory in your HomeSite install folder.
   NOTE: By default, the Parsers subdirectory can be found at:
      C:\Program Files\Macromedia\HomeSite 5\Parsers\

3. Use the Windows Registry Editor, regedit, to add a key named '*' to the path:
      HKEY_CURRENT_USER\Software\Macromedia\HomeSite5\Parsers
   1. Click Start, Run, and type: regedit
   2. Click OK
   3. Navigate the tree on the left hand side and find
         HKEY_CURRENT_USER\Software\Macromedia\HomeSite5\Parsers
   4. Right-click on Parsers and choose New, Key from the menu
   5. Rename the New Key to SOMEPARSER (this should match the filename of the new parser, minus the file extension)

4. Start HomeSite normally and use the Color Coding section of HomeSite's Options dialog to customize the '*' scheme to suit your needs. Use this dialog to add the filename extensions you want associated with this parser.

This assumes HomeSite v5. The registry path may be slightly different for other versions. Note that versions 4.x use the company name "Allaire" in the paths instead of "Macromedia." These instructions were originally written by Collier Jones.

Note that some syntax parsers can only be used in particular versions of HomeSite. Check any included readme files or check with the author to determine which HS version is required.

See also FAQ: Writing your own Syntax Coloring Parser Scripts and Script technique to Install or Swap Syntax Coloring Parsers.

---

Installation of Add-in Help

To install sets of normal html files:

1. Create a subdirectory under the Help subdirectory of your HomeSite install directory.
      Example: c:\program files\Macromedia\HomeSite 5\Help\MyAspHelp

2. Copy the files into this directory, making sure to maintain any relative subdirectories that are in the zip files.

3. In the HomeSite help pane, you may need to press F5 to refresh the listing to see the additions.

To use compiled html help files, install them where ever you like, then create a custom toolbar button set to "launch an external application" that points to the .chm file.

You might also see the following tips:

• Tip: Adding Help Docs to HomeSite
• Tip: Decompiling Compiled HTML Help Document Sets
• Tip: Linking PWS/IIS Docs into the HomeSite Help System
• FAQ: Writing or Converting Help Sets for HomeSite Use.

---

Installation of VTML Custom Dialogs

This procedure generically helps you set up toolbar buttons to call up custom dialogs. Some custom dialogs may have their own installation instructions.

1. Create a subdirectory under the Extensions subdirectory of your HomeSite install directory.
      Example: c:\program files\Macromedia\HomeSite 5\Extensions\MyDialogs

2. Unzip and copy the files into this directory, making sure to maintain any relative subdirectories that are in the zip files.

3. Start Homesite

4. Select Options | Customize | Toolbars

5. You can now either add buttons to an existing toolbar or create a new one. If you want to add a new toolbar, create it first by clicking "Add Toolbar" and providing a name. Now select the toolbar where you want to add a custom button for your custom dialog.
   1. Click on "Add Custom Button."
   2. On the Custom Toolbutton dialog, select "Display a custom dialog."
   3. Use the browse button to enter the path and filename of the custom dialog file.
   4. Browse to and enter the path and filename of the button image if you have one.
   5. Enter a caption and hint if you like.
   6. Click OK.

6. Repeat step 5 a-f if you have more than one dialog to add, then add any separators you want. You can sort buttons and separators on the toolbar by dragging them around. When you are finished click OK on the Customize Toolbar dialog.

7. If you created a new toolbar, you may need to turn on visibility of the toolbar at this point and drag it to a location or to the Quick Bar.

Note: You can install the dialog files where ever you would like, they don't have to go under your HomeSite install directory. This is just used as an example.

---

Installation of ExpressionBuilder Extensions

TBD. See specific instructions with each download.

---

Installation of WSH Scripts

To install scripts, see KB Article 13410.

---

Installation of Snippets Sets

1. Create a subdirectory under the UserData\Snippets subdirectory of your HomeSite install directory.
      Example: c:\program files\Macromedia\HomeSite 5\UserData\Snippets\MyNewSnippets

2. Extract and copy the files to this new subdirectory.

3. In the HomeSite snippets pane, you may need to press F5 to refresh the listing to see the additions.

You can also set up another directory for snippets and change the file location for snippets or shared snippets to point to the directory. These options are found under Options | Settings | File Locations.

These options were created to let teams share snippets across a network, but may also be used to point snippets elsewhere. Some users point HomeSite v4.x to HomeSite v3 snippets this way, rather than making a copy.

Snippets in HomeSite version 3.x are installed under the HomeSite\Snippets directory.

---

Installation of Toolbars

1. Copy toolbar file into the UserData\Toolbars subdirectory of your HomeSite install directory.
      Example: c:\program files\Macromedia\HomeSite 5\UserData\Toolbars

2. Run HomeSite.
3. Select Customize | Toolbars.
4. The new toolbar should be on the list, but won't be checked on yet. Check it.
5. Click Ok.
6. Now place the toolbar whereever you would like.