When you use DITA2Go to generate HTML Help, DITA2Go writes an .hhp project file during set-up, and rewrites it later only under certain conditions.
To specify whether DITA2Go should generate the .hhp project file anew each time you run the conversion:
[MSHtmlHelpOptions] ; WriteHelpProjectFile = Yes (write each time) or No; if no setting, ; write only if the file does not already exist. WriteHelpProjectFile = Yes
The values you can specify for WriteHelpProjectFile have the following effects:
If the configuration file contains no WriteHelpProjectFile setting at all, DITA2Go writes an .hhp file, but only if the .hhp file is not already present. |
DITA2Go closes the .hhp file after writing it; however, if you had the .hhp file open in HTML Help Workshop when DITA2Go rewrote it, you could get an access violation. (Notepad would just rewrite the old file over the rewritten one.)
If you set WriteHelpProjectFile=Yes and then later decide to modify the .hhp file, be sure to set WriteHelpProjectFile=No; otherwise your edits will be wiped out the next time you convert.
If you use HTML Help Workshop to make changes that are not reflected in the configuration file, and they are changes you want to keep, you can prevent DITA2Go from overwriting them by setting WriteHelpProjectFile=No.
If the changes you make via HTML Help Workshop are limited to defining windows, you can add those definitions to your DITA2Go configuration file to preserve them; see §18.8.1 Defining secondary windows for HTML Help.