This section enables you to add or overwrite sections of the HPJ project file used to generate your Winhelp output. (See Winhelp project files for details). Normally you will never need to use this feature but there may be situations when you want or need to make changes to your Winhelp output by making changes or additions to the HPJ file.
This feature is designed for advanced users familiar with manual Winhelp encoding! Please do not make any entries here unless you understand .hpj files and how to edit them. You can find information on the sections and settings in the documentation distributed with
Microsoft Help Workshop.
Normally Help & Manual generates the settings for the HPJ file automatically and you will almost never need to change them. If you do want to add settings that are not generally included you must enter them in with same format and syntax as in an INI file.
This example shows a typical HPJ file exported by Help & Manual to generate a Winhelp file:
Example of an .hpj file as exported by H&M |
; This file is maintained by HCW. Do not modify this file directly. [OPTIONS] HCW=0 COMPRESS=12 Hall Zeck LCID=0x409 0x0 0x0 ;English (USA) REPORT=Yes CHARSET=1 FTS=1 CONTENTS=Introduction TITLE=Help & Manual help CNT=.\HELPMAN.cnt COPYRIGHT=© 2005 EC Software, all rights reserved CITATION=© 2005 EC Software DEFFONT=MS Sans Serif,8,0 HLP=.\HELPMAN.hlp
[FILES] .\HELPMAN.rtf
[WINDOWS] Another="Secondary window",(110,276,679,408),27904,(r16777088),(r12632256),1 Main="Main window",(204,3,592,743),28420,(r16777215),(r12632256),f3 |
There is no [MAP] section in this file because no help context numbers were defined in any of the topics. Let's assume that you want to include another file that contains the mappings for context sensitive help. You can achieve this by adding the appropriate entry to the [MAP] section together with an #include statement to include the external file containing the mappings.
In addition to this, let's also assume that you want to change the target path of the compiled help file. This requires two lines in the [OPTIONS] section, one each for the main help file and the contents file.
To make these changes you would enter the following lines in the edit box of the Extended .HPJ Settings section:
[OPTIONS]
CNT=F:\data\common projects\help\helpman.cnt
HLP=F:\data\common projects\help\helpman.hlp
[MAP]
main_index=HID_MAIN
#include .\ProjektX.txt
The next time Help & Manual exports your project these lines will be merged with the standard output and the result will look like this (the inserted items are shown in red):
Merged .hpj file with manually-inserted lines: |
; This file is maintained by HCW. Do not modify this file directly. [OPTIONS] HCW=0 COMPRESS=12 Hall Zeck LCID=0x409 0x0 0x0 ;Englisch (USA) REPORT=Yes CHARSET=1 FTS=1 CONTENTS=Introduction TITLE=Help & Manual help CNT=F:\data\common projects\help\helpman.cnt COPYRIGHT=© 2005 EC Software, all rights reserved CITATION=© 2005 EC Software DEFFONT=MS Sans Serif,8,0 HLP=F:\data\common projects\help\helpman.hlp
[FILES] .\HELPMAN.rtf
[WINDOWS] Another="Secondary window",(110,276,679,408),27904,(r16777088),(r12632256),1 Main="Main window",(204,3,592,743),28420,(r16777215),(r12632256),f3 [MAP] main_index=HID_MAIN #include .\ProjektX.txt |
See the documentation distributed with Microsoft Help Workshop. for full details on HPJ files and their settings.
See also:
Winhelp (Help Formats)
Winhelp Options (Help Windows)