Help Integration Wizard Overview
The Help Integration Wizard takes an .hxs file as input and produces a Visual Studio deployment project. You can compile the deployment project to produce merge modules or an .msi file that will install, register, and merge your Help collection with Visual Studio.
To run the Help Integration Wizard
In Visual Studio, on the File menu, point to New, and then click Project to display the New Project dialog box.
In the Project Types pane, expand the Other Project Types folder, and then click Extensibility.
In the Templates pane, click Help Integration Wizard, type a project name in the Name box, and then click OK.
Follow the directions in the Help Integration Wizard pages.
This section describes the options available on Help Integration Wizard pages.
Choose Project Settings
Control how your Help collection will be deployed.
Deployment Project Type
Determines the type of deployment project the wizard generates.
The Setup project option creates both a merge module (.msm) project and a setup (.msi) project for your Help collection. Use this option when deploying the Help collection by itself.
The Merge module project option creates a merge module (.msm) project for your Help collection. Use this option when packaging the Help collection for use by someone else's setup project.
Specifies the version of Visual Studio with which your Help collection will integrate.
Select Collection Files
Choose the files that make up your Help collection.
Lists the files (.hxs, .hxi, .hxq, and .hxr) that make up your Help collection. The wizard allows your collection to have multiple .hxs files or .hxs/.hxi file pairs, but only one .hxq file and one .hxr file.
Displays the Add Help Files dialog box, which lets you navigate to files and select the ones you want for your Help collection.
Removes selected files from the Source Files list.
Build the TOC
Create your Help collection’s table of contents (TOC).
Help Collection TOC
Displays the Help collection’s TOC as it will appear in the Table of Contents window. Following is a key to the Help Collection TOC display:
For more information, refer to the HelpStudio Lite Help system, which is accessible from the Help menu of the HelpStudio Lite development environment.
Offers commands for editing the Help collection’s TOC, such as inserting and deleting nodes, moving nodes up and down in the hierarchy, setting node properties, and so on.
Exclude From TOC
Lists.hxs files in your Help collection that do not participate in the collection’s TOC.
Removes the selected .hxs file from the Exclude From TOC list and displays the file’s TOC in the Help Collection TOC tree view.
Removes the selected .hxs file’s TOC from the Help Collection TOC tree view and displays the .hxs file in the Exclude From TOC list.
Determines how the Help collection’s TOC will appear in the Table of Contents window.
The Hierarchical option creates a TOC with only one top-level node.
The Flat option creates a TOC that can have multiple top-level nodes.
Depending on the type of node selected in the Help Collection TOC tree view, clicking the Properties button on the toolbar displays one of the following dialog boxes:
Plug-in Node Properties
Allows you to change the title of a plug-in node of a hierarchical TOC.
Allows you to change the title, ID, and URL of a regular node.
Allows you to change the ID of an .hxs file’s TOC and view its URL.
Set Collection Properties
Set the properties of your Help collection.
Lists the categories of collection properties.
The Collection option lets you assign a namespace and description to your Help collection.
The HxC option lets you assign an ID, title, and version to the collection definition (.hxc) file.
The HxT option lets you assign an ID and version to the collection TOC (.hxt) file.
The K Index, F Index, A Index, and Named Url Index options allow you to assign an ID, title, and version to each of the collection’s index (.hxk) files.