(2)qhcp和qhc。qhcp是QtHelpCollectionProject的缩写,其主要作用是将qch二进制文件组织成为一个collection,定制客户化的Assistant;而qhc则是通过qcollectiongenerator命令生成的二进制文件,启动Assistant时需要指定collection参数,即qhc文件。qhc文件中是qch文件的集合,打开Assistant时,通过指定当前collection即可注册多个帮助文档。
从上面文件的解释看,我们需要手动完成两个文件即qhp和qhcp文件,通过这两个文件再生成最终需要的qch和qhc文件。qhp和qhcp文件都是XML文件,语法比较简单,这里不对语法进行详细介绍,具体可查看QtAssistant帮助文档。下面结合我在项目中对Assistant定制的过程进行总结,并给出了用到的qhp和qhcp文件的内容,这样更有助于从整体上对该过程进行把握。
定制过程中用到qhp,qch,qhcp,qhc四种不同格式的文件。对于这四种文件,初学者可能会经常混淆。至少我在开始用的时候,一头雾水。首先讲解一下这四种文件格式。这四种文件可以分为两组:
QtAssistant是Qt自带的一款可定制、可重新发行的帮助文件浏览器。QtAssistant支持HTML文件,用户可以利用其定制自己的功能强大的帮助文档浏览器。关于QtAssistant定制的资料主要是QtAssistant自身所带的英文文档,虽然讲解比较详细,但是对于初学者来说难以快速的入手。因此结合具体实践,对QtAssistant定制的过程进行整理,希望对他人能有所启发。
(2)编写qhp文件。下面是在项目中用到qhp文件,文件比较简单,这里仅用到了基本的功能,具体语法可以查看帮助文档。这里需要注意的是通过<section>标签指定帮助文档目录,这里可以是多级目录,但是Qt中建议不超过四级。指定目录后,需要通过<file>来指定所有用到的HTML文件,包括HTML文件中用到的所有图片。这里如果不指定,生成的qch文件注册到QtAssistant后将不能找到有效的文件进行显示。
<?xmlversion="1.0"encoding="utf-8"?>
<QHelpCollectionProjectversion="1.0">
<docFiles>
<generate>
<file>
<input>doc.qhp</input>
<output>doc.qch</output>
</file>
</generate>
<register>
<file>doc.qch</file>
</register>
</docFiles>
</QHelpCollectionProject>
<?xmlversion="1.0"encoding="utf-8"?>
<QHelpCollectionProjectversion="1.0">
<docFiles>
<register>
<file>doc.qch</file>

<file>其他的qch文件</file>
</register>
</docFiles>
</QHelpCollectionProject>
(6)运行QtAssistant。可以通过命令“qassistant-collectionfiledoc.qhc”打开qassistant,打开后即可浏览到我们自己的帮助文档了。当然如果是在程序中,可以通过QProcess来调用assistant.exe,并给出相应的collectionfile参数即可。
(3)生成qch文件。qhp文件完成后,通过qhelpgenerator命令生成压缩的qch文件。打开cmd,输入"qhelpgenerator doc.qhp -odoc.qch"。这里doc.qhp为输入的qhp文件,-o表示输出,输出文件名为doc.qch。
(1)制作HTML的帮助文件。由于原来的帮助文档是利用Word完成的,因此需要转换。转换的过程十分简单,即便对HTML不了解的用户也可以轻松完成。目前网络上有许多现成的HTML编辑器,利用这些编辑器即可轻松的进行编辑生成相应的html文件。
(1)qhp与qch。qhp是QtHelpProject的缩写,qch是QtCompressedHelp的缩写。qhp文件负责组织实际用到的帮助文件(通常为HTML文件,即需要在QtAssistant中浏览的文件),然后通过qhelpgenerator命令生成压缩的qch文件。qch文件是QtAssistant能够识别的文档最小单元,可以通过QtAssistant->编辑->首选项->文档标签页->添加/移除操作来注册或者注销一个qch文件。也可以通过命令“assistant-registerdoc.qch”来注册qch文件。注册后,即可在Assistant界面中浏览帮助文档。
<?xmlversion="1.0"encoding="UTF-8"?>
<QtHelpProjectversion="1.0">
<namespace>org.mitk</namespace>
<virtualFolder>doc</virtualFolder>
<filterSection>
<toc>
<sectiontitle="fMRIAnalyzeTutorial"ref="tutorial.htm">
</section>
</toc>
<files>
<file>tutorial.htm</file>
<file>Tutorial_files/clip_image002.jpg</file>
从以上可以看出,在qhcp文件中多了一个<generate>标签,并指定了输入qhp文件,和输出qch文件。文件里面可以指定多个qhp和qch,只要注意好文件直接的对应关系就可以了。
在编写qhcp文件时,建议采用(4)中的第二种方式,这样只需要一个命令即可生成qch和qhc文件,也避免了因为遗漏qch文件而造成qhc文件错误。
.....................................................................
<file>Tutorial_files/clip_image072.jpg</file>
</files>
</filterSection>
</QtHelpProject>副业赚钱项目推广
(5)生成qhc文件。通过qcollectiongenerator命令生成qhc文件,格式如下:“qcollectiongenerator doc.qhcp -odoc.qhc"。这里doc.qhcp文件输入的qhcp文件,-o表示输出,doc.qhc为生成的qhc文件名称。
(4)编写qhcp文件。qhcp中主要是对用到的qch文件进行组织,项目中用到的一个简单的qhcp文件如下:
从文件中可以看出,只需要在register标签中指定相应的qch文件名称即可。当前这里必须确保在qhcp文件目录下存在指定的qch文件。为了避免因为忘记生成qch文件而造成错误,qhcp中支持通过指定qhp文件从一次生成相应的qch和qhc文件。格式如下:
展开内容
7.5/921.5M
我的海上餐厅是一款模拟经营小游戏,玩家在游戏中需要合理经营自己的餐厅,安排好餐厅的各个环境的工作,你是非常忙碌的,为了赚更多钱,拥有更好的餐厅,去努力奋斗吧!我...
7.8/1,252.8M
对于小孩子来说数学的很重要,特别是加减法,这时就可以用100以内加减法考试器,就能让小朋友在轻松愉快的环境中进行记忆,而且还能把那些算错误的题目进行相关的保存,...
9.2/779.4M
学点是一款手机上的网络教学交流平台,不管是学生还是老师都可以在这里实现各种各样的教学内容,是目前国内比较受欢迎的移动网络教育和课堂学习的完美平台。学点介绍学点,...
7.8/1,087.0M
碧雪情天3D送1万真充版游戏场景非常的浪漫漂亮,3D引擎打造,非常的精致逼真,可以说是一款精品仙侠游戏。这个版本全新上线,福利满满,新玩家老玩家都应该试试。碧雪...
9.0/440.7M
APWiFiShareforWindows7是一款Win7WiFi共享软件,可以将无线网卡虚拟成WiFi信号,以便手机、平板电脑等无线设备共享互联网连接资源。软...
9.8/1,302.0M
家路是一款专门围绕家庭内部及亲戚朋友之间的记录、分享为中心社交产品。有了家路,就有了一段完美的家庭回忆录,在这里面你可以看到,感受到家人的温暖和成长!家路简介*...
8.1/949.8M
沃影票app是一款最新推出的电影票订购软件,软件由中国联通打造,用户可以在这里进行热门电影,附近影城一键搜索,新用户购票还有超多打折活动!沃影票特色热映电影,一...
8.2/37.4M
地铁跑酷横屏切换工具是一款可以让你体验横屏玩的小工具,直接一键设置,开启游戏后就变成横屏了,使用方法很简单,让你体验不一样的地铁跑酷玩法,欢迎来下载体验哦!软件...
9.3/516.9M
魔城之战1.27正式版是一款很火的魔兽防守地图,游戏同时支持人数为1-6人,本次更新等级上限增加到3000级,新增加了3个新区域和增加多种新装备,新区内刷材料合...
8.9/234.5M
吾爱云盘搜索是一款百度云的云盘搜索工具,可以通过关键字在百度云盘搜索自己想要的资源,搜索速度快,软件无需安装,打开即可使用,小巧方便,有需要的朋友可以下载。软件...
9.5/1,031.0M
暮色方舟是一款非常好玩的RPG类型的手游。在这款手游中,你将和超多日漫人物打交道哦~而且游戏中还有超多不同的职业等你来体验!这么好玩的游戏,还在等什么?快来下载...
8.4/1,009.7M
天公天和公连在一起打一成语答案是一款叫成语玩命猜里的一道题目有许多的朋友都答不上来这道题目,这道题的答案就在这里!成语玩命猜天公连一起是什么成语天下为公天下为公...
8.0/1,828.1M
良娣百宝盒是一个提供海量资源的手机百宝箱软件,界面简洁没有任何的广告,带给大家的各种功能都是可以免费使用的。用户还可以自由定制个性化的应用软件,操作起来非常简便...
7.7/717.2M
ArcFun建筑app是一款专为建筑行业打造的短视频平台,精选了海量行业视频,连接行业内资讯共享平台,随时随地了解最新事,在ArcFun,每一个视频都是惊喜!想...
10.0/1,546.0M
小红刷短剧APP是一款主打“随时便捷+高效观剧”的短剧观看工具,无需复杂操作,用户可快速找到并观看喜爱的短剧,同时提供贴心的管理功能,适配碎片化时间观剧需求,为...
8.8/31.3M
中国移动畅连app是一款支持远程控制的办公软件,该软件可以快速协助用户完成远程操控,除此之外,该软件还有其它多种有用的功能,感兴趣的小伙伴快来uzzf东坡下载吧...
7.7/503.1M
作为一名幼师总要找一些素材来丰富自己的课堂,是不是为此而苦恼呢?中国幼儿教师网专为幼师打造的工作助手——师乐汇是一个有着丰富幼师教学全资源素材库的应用,老师可以...
9.4/1,369.6M
粉色心形鼠标指针是现在女生里面最流行的鼠标指针,不论你的鼠标在干什么,你的鼠标总会现在一颗可爱的爱心出来,让你使用之后心情无比的愉快,觉得不错就赶紧下载。粉色心...
8.3/99.2M
轮渡管家app是一款非常实用和方便的轮渡服务软件。用户可以通过这款app实时查看不同轮渡路线、班次和详情,优化自己的海上旅行体验,并直接在平台上进行购票,无需前...
8.4/1,732.6M
飘飘宁宁ICO图标提取工具是一款非常好用的软件,可以提取各种软件的图标。只需一键,方便而且智能,有需求就来东坡下载吧。飘飘宁宁ICO图标提取工具特色1、支持操作...
8.3/542.7M
毕业设计,是在毕业的时候,按照学校、老师的要求完成跟本专业相关的作品设计,并且写出一个毕业设计报告给老师,这份2016土木工程毕业设计开题报告模板,可以让大家借...
7.8/1,841.9M
本软件适用于佳博标签打印机、支持蓝牙、WiFi,USB连接,操作简单方便,提供丰富的模板,支持一维、二维条码打印,图片打印,模板可以通过qq或微信分享给好友佳博...
8.1/1,087.3M
Xmanager是一款便捷浏览远端窗口系统的软件,该软件使用方便。该软件支持OpenGL硬件加速、更加强力的PCX服务器等功能。小编给大家带来了Xmanager...
9.5/850.5M
欣闻大字版app是一款专为中老年人打造的娱乐软件,app上有非常有趣的笑话段子,还有最精简的天气预报系统,app还未所有叔叔阿姨打造了超级厉害的照片影集制作软件...
8.9/1,907.0M
受到屡获殊荣的超过160万玩家的棋盘游戏的启发,Evolution已经登陆Android!通过令人难以置信的艺术和周到,平衡的机制,在一个美丽且不断变化的生态系...