#### 17.2.5 Setting basic WinHelp options in the configuration file

When you set up a WinHelp project, you must provide your own WinHelp.hpj file, and add or modify the configuration settings as follows:

1. For each heading format that starts a topic, specify properties:

       [HelpStyles]
       ; style = key list, where list members are separated
       ;  by spaces only
       ParaFmt = Property1 Property2 Property3 ...

   where:

   ParaFmt | is the name of the heading format
   PropertyN | is a help style attribute, such as Topic, Browse, or Key.

2. For each topic-starting heading format that should appear in the .cnt file, specify a Contents level. For example:

       [HelpCntStyles]
       ParaFmt=Contents level

   See §17.12.2.1 Understanding WinHelp contents level numbers.

3. Specify whether you want a combined .cnt file:

       [Setup]
       ; MakeCombinedCnt = Yes (default, when processing from open book)
       MakeCombinedCnt=Yes

4. Specify whether you want to run the help compiler automatically as the last conversion step (not recommended for large projects); if so, provide a name for the help project file:

       [Automation]
       ; CompileHelp = No (default, run help compiler separately), or Yes
       CompileHelp=Yes

       [HelpOptions]
       ; HPJFileName = name of .hpj to use when compiling help
       HPJFileName=myproj.hpj

To have DITA2Go copy the .hpj file to another directory after generating output files, specify the following:

    [Automation]
    WrapAndShip=Yes
    ; WrapPath = path to dir for compiling and distribution,
    ;  default is output dir
    WrapPath=.\help

See §44.6 Assembling files for distribution.

Previous Topic: 17.2.4 Accommodating platform differences

Next Topic: 17.2.6 Handling page breaks and section breaks

Parent Topic: 17.2 Setting up a WinHelp project

Sibling Topics:

17.2.1 Setting up a WinHelp project

17.2.2 Deciding where to locate configuration settings

17.2.3 Preparing a document for conversion to WinHelp

17.2.4 Accommodating platform differences

17.2.6 Handling page breaks and section breaks

17.2.7 Providing multiple .hlp files

17.2.8 Integrating WinHelp from RoboHelp

17.2.9 Compiling a WinHelp project

17.2.10 Checking WinHelp RTF files for DITA2Go version