Omni Systems, Inc.

  

Mif2Go User's Guide, Version 33u53

  

Valid HTML 4.01!

 

Made with Mif2Go

8 Generating Microsoft HTML Help > 8.2 Setting up an HTML Help project > 8.2.10 Compiling and testing an HTML Help project > 8.2.10.1 Directing Mif2Go to run the HTML Help compiler


8.2.10.1 Directing Mif2Go to run the HTML Help compiler

When you check Compile Help in the Mif2Go Export dialog (see §3.6 Converting documents), or specify the following options in the configuration file, Mif2Go automatically runs the HTML Help compiler after generating output files:

[Automation]

WrapAndShip=Yes

CompileHelp=Yes

For large projects, stick with CompileHelp=No; and after Mif2Go finishes the conversion, compile directly from HTML Help Workshop. Otherwise you might encounter memory limitations when Mif2Go tries to run the compiler.

Compiler must be on the system path

For Mif2Go to automatically run the HTML Help compiler, the following files must be on the system execution path:

hhc.exe

hh.exe

hha.dll

You might also want to set the following option, so you can see any error messages that result:

[Automation]

; KeepCompileWindow = No (default)

;  or Yes (so any error messages can be seen)

KeepCompileWindow=Yes

When KeepCompileWindow=Yes, a system window opens when the compiler runs. If there are no compilation errors, you will see only a command prompt when compilation finishes. You must dismiss the window before Mif2Go can continue processing.

If the compiler does not run when CompileHelp=Yes, try copying hh.exe and hhc.exe to C:\Windows, and hha.dll to C:\Windows\System32. Then restart FrameMaker before you run Mif2Go again.

To have Mif2Go copy the .hhp file to another folder for compiling, specify the following:

[Automation]

WrapAndShip=Yes

; WrapPath = path to dir for compiling and distribution,

;  default is output dir

WrapPath=./help

See §33.4 Assembling files for distribution.

See also:

§6.2.4 Compiling and distributing Help systems

§8.2.9 Locating graphics files for HTML Help

§8.2.10.2 Copying output files and compiling later



8 Generating Microsoft HTML Help > 8.2 Setting up an HTML Help project > 8.2.10 Compiling and testing an HTML Help project > 8.2.10.1 Directing Mif2Go to run the HTML Help compiler