Support Document

The information in this document applies to:

• HTML-Kit Build 290 and higher

When editing pages that contain server-side scripts (ASP, JSP, Perl, PHP, etc.) or server side includes (SSI), it may be necessary to go through a web server to be able to preview the final result. This document describes how to configure HTML-Kit to preview pages through a local or a remote web server.

Following steps assume that a web server is installed on the local system and that it is accessible at the default http://localhost/ address. A different address can be used to point to other local or remote web server.

Enable a Server Mapping (also known as a Preview Rule):

• Select "Edit | Preferences" from the main menu.
   
• Change to the "Preview" tab.
   
• Click "Edit Preview Rules."
   
• Click "Add" under "server mappings" and enter the local file path where documents are stored (for example: C:\MyWebSiteFiles\ ).
  
  A file path pointing to a network drive may be entered if using a web server running on a networked computer, instead of a web server installed on the local system. For example, assuming that X: is a network drive, the file path could be X:\inetpub\wwwroot\
  
  Click "OK."
   
• Enter the web server address that is used to preview files residing under the specified file path.
  
  For example, enter http://localhost/ if using a web server installed on the local system that's configured to serve files from the path above. Or enter a remote web server address to preview files that are stored on a remote server.
  
  Click "OK."
   
• Click "OK."
   
• Check the "Enable server mappings" option.
   
• Click "OK" to save the preferences.
   

Now when a file under the specified file path (such as C:\MyWebSiteFiles\test.html) is previewed, HTML-Kit will run it through the web server so that any server-side scripts can be processed before showing the final output.

Preview through the Workspace

• Right click a FTP server or a local/remote folder item listed in the Workspace.
  
  Select the "Workspace | Add FTP Server/Folder" main menu option if the server or the file path where the documents to be previewed reside is not already listed in the Workspace. The next step assumes that the related server or the file path already exists in the Workspace.
   
• Select "Properties."
   
• Change to the "General" tab.
   
• In the "Web root address" field, enter the web server address to use when previewing files under the selected Workspace item. This can be a web server address such as http://localhost or other remote web site address.
   
• Click "OK."
   

To preview a file under the configured Workspace item through the specified web server, right click a file or a folder and select "Preview."

Preview using an internal Browser Window

Select "Tools | Open New Browser Window" from the main menu and enter the web page address to preview. The "Tools | Browser Bookmarks" option can be used to keep a list of frequently accessed web site addresses.

Check the Plugins page

For more preview options, look for custom plugins related to previewing documents.

• How to: Create file mappings
• How to: Use Preview Plugins

THE INFORMATION IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS WITHOUT WARRANTY OF ANY KIND. PROVIDER SPECIFICALLY DISCLAIMS ANY OTHER WARRANTY, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL PROVIDER BE LIABLE FOR ANY CONSEQUENTIAL, INDIRECT, SPECIAL OR INCIDENTAL DAMAGES, EVEN IF PROVIDER HAS BEEN ADVISED BY "USER" OF THE POSSIBILITY OF SUCH POTENTIAL LOSS OR DAMAGE. "USER" AGREES TO HOLD PROVIDER HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS, LOSSES, LIABILITIES AND EXPENSES.