大家好,欢迎来到IT知识分享网。
本文主要介绍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表示所用字符集,常用数值
|
宋体,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://yundeesoft.com/31730.html