制作CHM文件简易教程

用HTML Help Workshop制作chm文件很方便，下面就以“中华搜索宝CHINASSB”的软件说明为例，介绍制作的具体步骤。

一、制作前的准备工作

由于chm帮助文件是基于HTML文件特征的，所以前期编写HTML文件的准备工作很重要。HTML Help Workshop的角色就像是一个总管，以一个项目控制整个项目的各类型文件，然后将各类型的文件编译成独立的chm文件。它的每个主题就是一个HTML文件，它的结构有点类似平常我们所见到的目录树，但是它的主题包括目录及文件。主题文件可以用任何一个HTML编辑器进行编辑，也可用HTML Help Workshop编辑，唯一美中不足的是它的编辑器是纯文字模式，对于HTML文件而言不具备所见即所得的效果。

如果你不会制作网页，没关系，你也可以通过Word 97或Word 2000，将Word格式的主题文件转换成HTML格式。

二、创建项目文件

第一步：点击HTML Help Workshop菜单栏中的“File/New”命令，这时出现“选择新建内容”的对话框，选中“Project”。

第二步：，按“OK”按钮后，将“Convert WinHelp Project”这个选项留空，继续下一步。

第三步：点击“Browse”按钮，设置放置项目文件的目录及项目文件名，完成后，继续下一步。

第四步：因为我们已经事先建好了html文件，此时请选择“HTML file”，继续下一步。

第五步：点一下“Add”按钮并加入已经编辑好的主题文件（也就是设置成首页面的HTML文件）。点击“下一步”，最后点击“完成”按钮，新的项目即已新增完成。

现在就可以进入HTML Help Workshop工作窗口。在窗口的上方是3个卷标，分别是“Project（项目）”、“Contents（目录）”、“Index（索引）”。

在“Project”卷标的左侧是7个按钮，它们的功能名称自上而下分别是：“Change project options（改变项目选项）”、“Add/Remove topic files（添加/删除主题文件）”、“Add/Modify window definitions（添加/修改窗口定义）”、“HtmlHelp API information（HTML帮助API信息）”、“View HTML source（校验HTML源文件）”、“Save Project Contents and Index files（保存项目、目录和索引文件）”、“Save all file and Compile（保存全部文件并编译）”。

第六步：点击“Project”编辑窗口下方的“Change Project Options”按钮后，会弹出一个“Options”对话框。在这个对话框的“General”卷标的“Title”中输入标题“中华搜索宝CHINASSB”，编译后这个标题将出现在chm文件窗口的标题栏中。在“File”卷标中选上“Automatically create contents file（.hhc） when compiling”。

chm文件的“Search（搜索）”选项允许用户在所有主题文件中搜索字、词或短语，将它们的标题显示出来，而且用醒目的方式显示在主题中。在“Compiler”卷标中选上“Compiler full－text search information”，即可支持全文检索功能。

第七步：点击“Save project file and compile”按钮，虽然此时已经可以观看结果了，不过，我们要再多作一项设定让最后的成品再完整些。

三、创建目录文件

编辑目录文件是制作chm文件最关键的工作。目录文件应该包含一个chm文件所有目录（主题），而每个目录又包含条目标题（名称）和该条目的主题文件，要避免条目标题与对应的主题不一致的情况出现。等所有目录都添加好后目录就算完成了。

第一步：点击HTML Help Workshop工作窗口的“Contents”卷标，这时系统弹出一个对话框，提示你“项目”还没有关联目录文件（.hhc），选择“Create a new contents file”，点击“OK”按钮后将创建一个新的目录文件。

第二步：请指定一个新目录文件名和存放路径，点击“保存”后出现目录编辑窗口，目录编辑窗口的左侧有11个按钮。

第三步：根据需要插入标题（类似资源管理器中的目录）或页面（类似资源管理器中某目录下的文件），按下“Insert a heading（插入标题）”或“Insert a page（插入页面）”按钮，都会弹出“Table of Contents Entry”对话框，在“Entry title”输入框中输入条目的标题，并根据情况选定对应的主题文件，单击“Entry title”下的“Add”按钮，在弹出的对话框下面的“File or URL”输入框中输入文件名或URL地址并确定。

第四步：如果在单击“Insert a page”按钮之前所选择的条目不包含别的条目，也不被别的条目所包含，那么会询问“Do you want to insert this entry at the beginningof the table of contents？”，选择了“是”会增加起始条目（一级条目），选择了“否”会增加一个子条目。

标题可以分为多级，要按照制作的内容统一考虑。如果觉得不满意，可以用左侧的箭头进行调整，也可以选定该条目，单击鼠标右键，不但可以调整，还可以插入标题、主题或目录文件。

完成目录编制后，一个chm文件已具备了雏形，索引的内容暂时空着。保存项目文件和目录文件后就可以编译，编译就是把所有用到的HTML文件统统压缩后包装在一起，形成一个后缀名是.chm的文件。在主工具栏按钮中可以找到编译按钮和试运行按钮，也可直接按项目窗口左下方的“SaveallfileandCompile（保存全部文件并编译）”按钮进行编译。译后再运行就可以看到作品的面貌了。目录的内容在编译后显示在chm文件窗口的左侧，可以展开标题后显示以下的目录，单击目录可以打开相应的主题文件，显示相应的内容。如果发现问题，还可以进行修改调整。

四、创建索引文件

索引文件（hhk）也是一个HTML文件，它包含若干个关键词，当用户打开chm文件后，单击索引标签并输入一个关键词后，chm文件将显示与这个关键词有关的主题的列表，使大家非常方便地找到相关主题。

第一步：点击HTML Help Workshop工作窗口的“Index”卷标，这时系统弹出一个对话框，提示你“项目”还没有关联索引文件（.hhk），选择“Create a new contents file”，点击“OK”按钮后将创建一个新的索引文件。

第二步：请指定一个新索引文件名和存放路径，点击“保存”后出现索引编辑窗口，索引编辑窗口的左侧有11个按钮。

第三步：单击“Insert a keyWord”按钮，出现“Index Entry”对话框，在“General”选项的“KeyWord”输入框中输入关键词，再单击“Add”按钮添加与该关键词相关联的主题文件。如果想跳转到另一个关键词，在“Index Entry”对话框中按“Advance”选项，选中“Target is Another KeyWord”，再单击“General”选项的“KeyWord”输入框中输入关键词，再单击“Add”按钮添加与要跳转的关键词相关联的主题文件，单击“OK”按钮。最后单击“确定”按钮，并按“Save file”进行存盘。

五、创建搜索

chm文件的“Search（搜索）”选项卡允许用户在所有主题文件中搜索字、词或短语将它们的标题显示出来，而且在主题中用醒目的方式来显示。打开一个项目文件，单击“Project（项目）”选项卡的“Changeprojectoptions（改变项目选项）”，在“Options（选项）”对话框的“Compiler（编译）选项卡中选中“CompileFullTextSearchInformation（编译全文搜索信息”即可。

只要有完整的HTML源文件，激活HtmlHelpWorkshop创建一个新的项目文件，将第一个html（通常是default.htm或index.html）加进项目，存盘并编译就大功告成。同样的一组HTML文件，放在网站上是一页一页的网页，变成单一的chm后，则可用作软件辅助说明，而且已经内建了全文检索功能。

上述介绍的只是制作chm帮助文件的基本步骤。但它的功能远非这些，如：可向HTML文件中插入HTMLHelpActiveX控件、Java脚本、弹出式窗口等等。还可将已有的chm文件解压缩变回原来的HTML文件。

六、最后的设置工作

第一步：选择“Project”卷标，点击“Change Project Options”按钮，在“File”卷标的“Content file”项目中，点击“Browse”指定为toc.hhc。在“Index file”项目中，点击“Browse”指定为index.hhc。

第二步：重新点击“Save project file and compile”按钮进行存盘编译。

第三步：最后点击主菜单“View/Compiled file”，通过“Browse”指定该chm文件的目录及文件名即可看到我们的作品了。

C#生成CHM文件（入门篇）




HTML Help Workshop介绍：微软出品的HTML Help WorkShop制作chm文件的最佳工具。
本文，我们将用编程的方法来实现将html文件编译成CHM文件。在开始编程之前，我们有必要了解下HTML Help Workshop是怎么生成CHM的。
HTML Help Workshop编译成CHM文件需要如下三个文件，分别以hhp，hhc，hhk为文件后缀名。
hhp:CHM工程文件,CHM目标文件属性95%的参数都在这里被确定.

hhc,列表文件,确定目标文件中左侧树形列表中"目录"选项卡下的内容.

hhk,索引文件,确定目标文件中左侧树形列表中"索引"选项卡下的内容.

hhp几乎就是一个标准的ini文件.分为三个小节Option,Windows,Files.
典型的配置文件(hhp)结构如下：
[OPTIONS]

Compatibility=1.1 Or later

Default window=Main

Default font=宋体,9,1

Contents file=test.hhc

Index file=test.hhk

Display compile progress=Yes

Full-text search=Yes

Language=0X804 中文(中国)
[WINDOWS]

Main=,"test.hhc","test.hhk",,,,,,,0x20,0xB4,0x104E,[80,60,720,540],0x0,0x0,,,,,0
[FILES]

NewTopic.html
 
稍微解释下：
 Default window=Main：默认的显示模式，这里是主页面
 Default font=宋体,9,1：默认的字体
 Contents file=test.hhc：内容文件
 Index file=test.hhk：索引文件
 Display compile progress=Yes：是否显示编译过程
 Full-text search=Yes：是否全文搜索
 Language=0X804 中文(中国)：默认语言
 
索引文件（hhk）也是一个HTML文件，它包含若干个关键词，当用户打开chm文件后，单击索引标签并输入一个关键词后，chm文件将显示与这个关键词有关的主题的列表，使大家非常方便地找到相关主题。 典型的文件结构如下：
 
DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<HTML>
<HEAD>
<meta name="GENERATOR" content="Microsoft® HTML Help Workshop 4.1">

HEAD>
<BODY>
<UL>
 <LI> <OBJECT type="text/sitemap">
 <param name="Name" value="NewTopic">
 <param name="Local" value="NewTopic.html">
 OBJECT>
UL>
BODY>
HTML>
 

内容页项目资源（hhc）文件结构如下：
DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<HTML>
<HEAD>
<meta name="GENERATOR" content="Microsoft® HTML Help Workshop 4.1">

HEAD>
<BODY>
<OBJECT type="text/site properties">
 <param name="Window Styles" value="0x237">
OBJECT>
<UL>
 <LI> <OBJECT type="text/sitemap">
 <param name="Name" value="NewTopic">
 OBJECT>
<UL>
 <LI> <OBJECT type="text/sitemap">
 <param name="Name" value="NewTopic">
 <param name="Local" value="NewTopic.html">
 OBJECT>
UL>
UL>
BODY>
HTML>

 
 
用C#编程实现编译，其实是利用Process类来调用exe实现的。
Process helpCompileProcess = new Process(); //创建新的进程，用Process启动HHC.EXE来Compile一个CHM文件
 try
 {
 //判断文件是否存在并不被占用
 try
 {
 string path = _chmFile; //chm生成路径
 if (File.Exists(path))
 {
 File.Delete(path);
 }
 }
 catch
 {
 throw new Exception("文件被打开！");
 }

 ProcessStartInfo processStartInfo = new ProcessStartInfo();
 processStartInfo.WindowStyle = ProcessWindowStyle.Hidden;
 processStartInfo.FileName = hhcFile; //调入HHC.EXE文件 
processStartInfo.Arguments = "\"" + Path.GetFullPath(GetPathToProjectFile()) + "\"";//获取空的HHP文件
 processStartInfo.UseShellExecute = false;
 helpCompileProcess.StartInfo = processStartInfo;
 helpCompileProcess.Start();
 helpCompileProcess.WaitForExit(); //组件无限期地等待关联进程退出

 if (helpCompileProcess.ExitCode == 0)
 {
 MessageBox.Show(new Exception().Message);
 return false;
 }
 }
 finally
 {
 helpCompileProcess.Close();
 }
 return true;
 
 
附件是项目，.Net4.0的，有兴趣的可以在其他版本上也实现下，只要将文件拷过去即可。
如果是vs2010，直接运行项目即可，在运行项目之前可以先把CreateChm\bin\Debug目录下的hhp、hhc、hhk、chm文件全部删掉，运行程序后后生成这些文件。

 PS:我尝试将一些引用js文件和图片的html文件，将他们编译为chm文件时，这些js文件和图片能够自动被包含到chm文件中，呵呵，这样就可以创建丰富多彩的chm文件了，如我给的demo中，指针就是一个漂亮的时钟，关于更复杂的CHM编程，稍后带来。

  

    
CHM Editor
    
.chm的各种官方文档查看工具
  

提起制作chm电子书，那么就不得不提到大名鼎鼎的WinCHM了。WinCHM不仅可以制作图文并茂的电子书，而且还提供了非常多的自定义选项，做出的chm电子书也小巧、稳定、好用。

那么，怎样使用WinCHM制作chm电子书呢？下面就来教大家方法。

工具/原料


	
WinCHM
	
一、准备工作


	
1

	
首先，根据要制作chm电子书的目录层次，准备好来制作的 html 文件。比如说，我们要制作如图所示的chm电子书“DirectX 11 手册”，它在根目录下有三个子目录，然后在每个子目录下又分别有文档或子目录。

	

	
	

	
2

	
我们就需要先新建一个文件夹DX11手册，然后根据以上目录层次结构，在相应目录下再新建子目录或 html 文档。

	


	
END
	
二、制作chm


	
准备工作完成后，启动WinCHM，按顺序完成以下步骤：

	
1）点击“新建”

	
2）在弹出的对话框中选中“使用现有的HTML文件创建一个项目”

	
3）填写项目标题

	
4）勾选“保持文件夹结构”

	
5）最后在“HTML位置”后的按钮处点击，找到之前已经准备好的HTML文件的目录，再点击确定。

	


	


	

	
	

	
目录导入成功后如图所示，现在，我们可以根据需要增删目录或文件，也可以调整它们的顺序。方法是：

	
1）调整层级或排序

	
先选中要调整的目录或文件，然后点击最左侧的那些箭头。其中上下箭头是调整排序的，而左右箭头是调整层级的。

	
2）增加或删除文件或目录

	
先选中相应的文件位置，然后点击左侧的删除图标或增加图标。

	

	
	

	
调整完毕后，点击菜单“编译”-“构建”-“HTML帮助”，再按图示步骤打开“设计CHM样式”。

	


	


	

	
	

	
打开的样式窗口如图所示，我们可以在设置区自定义自己喜欢的窗口样式。

	

	
	

	
在这儿提醒大家注意两个方面：

	
1）如果某项功能不需要，则可以取消勾选，预览区相应的组件或按钮就消失。

	
2）设置完成后一定要记得点击确定按钮，否则更改不会生效。

	

	
	

	
设置完成后，点击菜单“构建”旁边的向下箭头，再点击“HTML帮助”，然后再在弹出的对话框中点击“开始”即可开始编译CHM电子书了。