OmniHelp design

The OmniHelp project file, _project.htm, serves as the initial loader of the frameset. The ohstart.js script checks the .ohx to determine whether a new window is wanted (newWindow), and if so opens one with titlebar,title,status,resizable properties, plus whatever is specified for frameOptions (comma-separated with no spaces), sized according to frameHigh and frameWide. The list of potential options is very long, and is browser dependent; refer to JavaScript docs for the possibilities.

If a new window is specified, but cannot be opened (perhaps because popups are disabled in the current browser), the existing window is used instead. Otherwise, if closeWindow is also specified, an attempt is made to close the original window; the success of this is very browser-dependent. NS 7.1, for example, refuses to close the original window because it was not opened by the same script that is trying to close it.

The project file can have any name you please; not just _project.htm, which was chosen so that the name would appear at the top of an alphabetized directory. In some cases, the name index.html may be best, so that an OmniHelp doc (perhaps on a Web site) can be referenced solely by the name of the containing directory.