hhp文件结构介绍

hhp文件结构介绍本文主要介绍hhp格式文件的内部文本结构,hhp是生成chm文件过程中的中间文件,详见alexis的《C#生成chm文件(入门篇)》HHP:是HTMLHelpProject的简称,通过微软的HTMLHelpWorkshop编译chm文件时会用到此格式文件。目前网络上对此的文件个格式众说纷纭

大家好,欢迎来到IT知识分享网。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://yundeesoft.com/31730.html

(0)

相关推荐

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注微信