33.8 Gathering and compiling Help-system files

Most Help systems require additional steps after Mif2Go generates output files from your FrameMaker document, and before archiving files for distribution. You can have Mif2Go automatically do the following:

WinHelp	Run the WinHelp compiler; see §7.1.11 Compiling a WinHelp project.
HTML Help	Run the HTML Help compiler; see §8.2.10 Compiling and testing an HTML Help project.
OmniHelp	Copy viewer files to the WrapPath folder (needed only if they are not already in the output folder); see §9.13 Assembling OmniHelp files for viewing.
JavaHelp	Run the full-text-search indexing program; see §10.4.2 Creating a search index for JavaHelp.
Oracle Help for Java	Run the full-text-search indexing program (although you might not get a usable search index); see §10.4.3 Creating a search index for Oracle Help.
Eclipse Help	Archive topic files into doc.zip; see §11.7 Packaging Eclipse Help files.

Certain automation settings are activated

When CompileHelp=Yes or FTSCommand=command\to\run\indexer, Mif2Go acts on those [Automation] settings that need to be processed prior to compilation or indexing, regardless of the setting for WrapAndShip. Then Mif2Go runs the appropriate compiler or indexer. Table 33-4 shows which settings are activated.

Table 33-4 Automation settings activated by CompileHelp or FTSCommand

[Automation] setting	Action	Ref.
CopyCssFrom	Copy CSS files from the designated folder	33.6
CopyGraphicsFrom	Copy graphics files from the designated folder	33.5.1
CssCopyFiles	Select only specified CSS files for copying	33.6
DeleteExistingMIF	Delete prior MIF files from the output folder before conversion	33.3.4
EmptyGraphPath	Delete prior copied graphics files before copying	33.5.2
EmptyOutputDir	Delete files from the output folder before conversion	33.3.1
EmptyOutputFiles	Select only specified files to delete from the output folder	33.3.2
EmptyWrapPath	Delete all files from the WrapPath folder before copying	33.4
GraphCopyFiles	Select only specified graphics files for copying	33.5.1
KeepCompileWindow	Keep the compiler window open after compiling: for WinHelp for HTML Help	7.1.11 8.2.10.1
WrapCopyFiles	Copy only specified files from the output folder	33.4
WrapPath	Folder to which files are copied for compiling or distribution	33.4
ShipPath	Folder to which compiled or archived files are copied or moved	33.10

Assemble files without compiling or indexing

When CompileHelp=No (the default for WinHelp and HTML Help), or FTSCommand is not specified for JavaHelp or Oracle Help, you must run the compiler or indexer separately. If WrapAndShip=Yes, uncompiled or unindexed Help-system files are assembled for distribution; see §33.2 Activating and logging production of deliverables. You might use this combination for WinHelp if you are sending files to be branded by a subcontractor, or to be integrated with other WinHelp systems. For HTML Help, you might send uncompiled files for use on a server.

Assembling and archiving are optional

For WinHelp or HTML Help you can get away without specifying WrapPath for compiled Help output, because the compiler relies on a list of files to include in the compilation. Omitting WrapPath avoids creating a duplicate set of output files in a second folder. Also, archiving is not always necessary for compiled Help, because compilation itself creates a compressed deliverable.

Convert first, compile and archive later

Having Mif2Go run either Help compiler as part of the conversion can be problematic for large projects. Instead, you can do the conversion as a first step, then run Mif2Go again to compile and prepare the deliverable; see §33.12 Postprocessing separately from converting.

---

> 33 Producing deliverable results > 33.8 Gathering and compiling Help-system files