Web Pages Folder

Web target files and template files are in the Web Pages folder in the Intermapper Settings folder. Except for the folders described below, the Intermapper web server serves only files that are located in the top level of the Web Pages folder.

Overriding the Built-In Pages

Intermapper ships a single zip archive called BuiltinWebPages.zip.

To customize pages, you need to create a directory structure that matches the structure within BuiltinWebPages.zip file. Any files placed in those folder override pages of the same name in the zip archive.

Contents of BuiltinWebPages.zip

The BuiltinWebPages.zip file contains the following folders:

  • AdminHTML

    This folder contains HTML templates for pages that show the overall status of the Intermapper program. People with access to these pages can also view all the separate map pages. You can access these files from the default web URL, or by using a URL in the following format:

    http://intermapper.domainname.com/~admin/filename.html

  • GuestHTML

    This folder contains HTML templates for reporting errors such as missing or invalid file names, and for responding to web clients who are not authorized for the web server. These files bypass the usual access list mechanism; you can access them using the following URL format: 

    http://intermapper.domainname.com/~error/filename.html

  • GuestImages

    This folder contains images used by the Intermapper web server. These images can be placed in a target or template file using the ${imageref: ... } macro.

  • PerMapHTML

    This folder contains HTML templates that are used to display information about a map. To view a specific document's information, use the following URL format: 

    http://intermapper.domainname.com/docname

The zip archive also contains some supporting files, including JavaScript files, located in the root of the folder.

How Web Page Files are Used

Main Web Page

The main web page is the ~admin/!index.html target file. When an unqualified URL request arrives (that is, a request for "/", without any additional path of file information), Intermapper sends the file specified by ~admin/!index.html.

Main Template file

By default, all target files use the same template (!template.html) (note the exclamation point (!) at the beginning of the filename). A target file can specify a different template file by using the #template directive.

Default HTML page

For both the ~AdminHTML and PerMapHTML folders, the default HTML page is !index.html. A request for http://intermapper.domain.com/ is treated like a request for the following:

http://intermapper.domain.com/~admin/!index.html.

Similarly, a request for the following:

http://intermapper.domain.com/docname

is treated like a request for the following:

http://intermapper.domain.com/docname/document/main/!index.html.