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编程,稍后带来。
PS:如果觉得的好的话,请点推荐,如果值得收藏的话,请点收藏,3Q
C#创建简易CHM文件Demo