5.9. Windows HTML Help

Preparing Cogent Documentation :
	Chapter 5. Special Organization

In June 2003 we added Windows HTML Help as one of the possible outputs from the processing toolchain, as illustrated in Section 6.1.2, “XML Tools”. This output format requires 3 pieces of information in addtion to the SGML source code:

The path and filename of a document-specific stylesheet that is used to set certain document-specific paramenters.
A document name string to identify the document within Windows.
The file name of the first page that you want the browser to open to when the Help file is opened.

We put these three items in the above order into a three-line file called winparms.txt, located in the doc/o/xx-book/ directory, making it available to the sgml.mak makefile. For example, the winparms.txt file for doc/o/cc-book/ looks like this:

../../config/hhconnect.xsl
CascadeSetup
ch06.html

During the make process, these three items get picked up and fed as parameters to cogsgml.


5.8. Gamma/GTK manual		Chapter 6. Tools