hhp文件结构介绍

本文主要介绍hhp格式文件的内部文本结构,hhp是生成chm文件过程中的中间文件,详见alexis的《C#生成chm文件(入门篇)》

HHP:是HTML Help Project的简称,通过微软的HTML Help Workshop 编译chm文件时会用到此格式文件。目前网络上对此的文件个格式众说纷纭,但还没有一个全的,我仅整理出能搜到的资料。这种文件格式类似.ini的文件格式。

注意如果[WINDOWS]配置节的长度超过1024个字符,会导致无法编译出chm文件。

注意文件中的所有路径不能包含中文。

典型的hhp文件结构如下:

[OPTIONS]
Auto Index=Yes
Binary TOC=Yes
Compatibility=1.1 or later
Compiled File=CHM-example.chm
Contents File=CHM-example.hhc
Default Window=main
Default Topic=index.htm
Display compile progress=Yes
Error log file=_errorlog.txt
Full-text search=Yes
Index File=CHM-example.hhk
Language=0x804 中文(中国)
Title=Online Help
Binary Index=Yes
Default Font=宋体,9,134
Create CHI file=No
Full text search stop list file=
Display compile notes=Yes

[WINDOWS]
main="Online Help","CHM-example.hhc","CHM-example.hhk","index.htm","index.htm",,,,,0x23520,275,0x1046,[317,243,947,683],0xB0000,,,,,,0
wndTopic="New Topic Window","CHM-example.hhc","CHM-example.hhk","index.htm","index.htm",,,,,0x23520,122,0x1046,[669,7,1017,728],0xB0000,,,1,,,0

[FILES]
CHM-example.hhp
CHM-example_INDEX-2.hhk
CHM-example_TOC-2.hhc
design.css
index.htm
Context-sensitive_example\contextID-10000.htm
Context-sensitive_example\contextID-10010.htm
Context-sensitive_example\contextID-20000.htm
Context-sensitive_example\contextID-20010.htm
Context-sensitive_example\contextID-30000.htm
embedded_files\example-embedded.doc
embedded_files\example-embedded.pdf
Garden\flowers.htm
Garden\garden.htm
Garden\tree.htm
HTMLHelp_Examples\CloseWindowAutomatically.htm
HTMLHelp_Examples\example-external-pdf.htm
HTMLHelp_Examples\Jump_to_anchor.htm
HTMLHelp_Examples\LinkPDFfromCHM.htm
HTMLHelp_Examples\pop-up_example.htm
HTMLHelp_Examples\shortcut_link.htm
HTMLHelp_Examples\Simple_link_example.htm
HTMLHelp_Examples\topic_split_example.htm
HTMLHelp_Examples\image_and_text.htm
images\blume.jpg
images\ditzum.jpg
images\eiche.jpg
images\extlink.gif
images\insekt.jpg
images\list_arrow.gif
images\lupine.jpg
images\riffel_40px.jpg
images\riffel_helpinformation.jpg
images\riffel_home.jpg
images\rotor_enercon.jpg
images\screenshot_big.png
images\screenshot_small.png
images\verlauf-blau.jpg
images\verlauf-gelb.jpg
images\verlauf-rot.jpg
images\wintertree.jpg
images\snow_village.jpg

 

[OPTIONS]配置节各属性含义如下:

属性名属性作用属性值格式例子
Compatibility
指明生成的chm的兼容性HTML Help版本,最新是1.4
1.1 Or later
Default window
指明生成的chm默认显示的窗口如果[Window]配置节包含多行,则需制定默认显示的窗口   main
Default font
指明生成的chm默认的字体样式,包括字体,字号等
string , number ,number格式,string表示字体,第一个number表示字体大小,单位像素。第二个number表示所用字符集,常用数值
含义如下:1:DEFAULT 2:SYMBOL 255:OEM 0:ANSI 134:GB2313(简体中文) 136:BIG5繁体中文

宋体,9,1
Default Topic
指定chm文件刚打开时的首页
这里可以写文件路径,文件必须是被列在[FILES]配置节中的htm或html文件,且文件在指定路径存在
index.htm
Compiled file
指定生成的chm文件的名字及路径
同样可以写文件路径,chm文件名可以和hhp,hhc,hhk不同
CHM-example.chm
Contents file
指明生成的chm的目录所对应的中间文件hhc扩展名的文件,这里可以加文件路径(用“\”区分层级),绝对路径,相对路径都可以。如果不加路径,默认和本hhp文件相同路径。
test.hhc
Index file
指明生成的chm的目录所对应的中间文件hhk扩展名的文件,这里可以加文件路径(用“\”区分层级),绝对路径,相对路径都可以。如果不加路径,默认和本hhp文件相同路径。
CHM-example.hhk
Display compile progress
是否显示编译过程如果设为yes,则集成调用dda.dll时会返回编译信息。    yes
Full-text search
是否支持全文搜索 注意:光这里设置yes还不能使生成chm支持搜索,还需要在Window配置节进行相应设置   yes
Language
显示语言 0x表示16进制,后边的804代表简体中文的LCID的不加零写法,各个语言的LCID见Locale IDs  0x804

   Title

指定chm文件标题栏的标题

可以写中文

  HTML Help

   full text search stop list file

指定一个txt文件,里边是搜索时的忽略词 

因为全文搜索时,首先会生成索引,也就是每一个字符及所在的目录,这种索引不能自动识别无意义又大量重复的字,

比如“的”,“是”,“得”,“地”。这些词会在生成的chm文件中占用大量空间,所以如果需要更小的chm,此处可以写一个txt清单。不需要则留空

  ftsslf.txt 

 参考:

[1].Unofficial (Preliminary) HTML Help Specification,HTML Help Projects,2005-3-6

[2].HTMLHelp,help-info.de,2006

转载于:https://www.cnblogs.com/imagefly/p/3869077.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值