(1)制作HTML的帮助文件。由于原来的帮助文档是利用Word完成的,因此需要转换。转换的过程十分简单,即便对HTML不了解的用户也可以轻松完成。目前网络上有许多现成的HTML编辑器,利用这些编辑器即可轻松的进行编辑生成相应的html文件。
(3)生成qch文件。qhp文件完成后,通过qhelpgenerator命令生成压缩的qch文件。打开cmd,输入"qhelpgenerator doc.qhp -odoc.qch"。这里doc.qhp为输入的qhp文件,-o表示输出,输出文件名为doc.qch。
从上面文件的解释看,我们需要手动完成两个文件即qhp和qhcp文件,通过这两个文件再生成最终需要的qch和qhc文件。qhp和qhcp文件都是XML文件,语法比较简单,这里不对语法进行详细介绍,具体可查看QtAssistant帮助文档。下面结合我在项目中对Assistant定制的过程进行总结,并给出了用到的qhp和qhcp文件的内容,这样更有助于从整体上对该过程进行把握。

(2)编写qhp文件。下面是在项目中用到qhp文件,文件比较简单,这里仅用到了基本的功能,具体语法可以查看帮助文档。这里需要注意的是通过<section>标签指定帮助文档目录,这里可以是多级目录,但是Qt中建议不超过四级。指定目录后,需要通过<file>来指定所有用到的HTML文件,包括HTML文件中用到的所有图片。这里如果不指定,生成的qch文件注册到QtAssistant后将不能找到有效的文件进行显示。
(1)qhp与qch。qhp是QtHelpProject的缩写,qch是QtCompressedHelp的缩写。qhp文件负责组织实际用到的帮助文件(通常为HTML文件,即需要在QtAssistant中浏览的文件),然后通过qhelpgenerator命令生成压缩的qch文件。qch文件是QtAssistant能够识别的文档最小单元,可以通过QtAssistant->编辑->首选项->文档标签页->添加/移除操作来注册或者注销一个qch文件。也可以通过命令“assistant-registerdoc.qch”来注册qch文件。注册后,即可在Assistant界面中浏览帮助文档。
<file>其他的qch文件</file>
</register>
</docFiles>
</QHelpCollectionProject>
<?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>
(4)编写qhcp文件。qhcp中主要是对用到的qch文件进行组织,项目中用到的一个简单的qhcp文件如下:
(2)qhcp和qhc。qhcp是QtHelpCollectionProject的缩写,其主要作用是将qch二进制文件组织成为一个collection,定制客户化的Assistant;而qhc则是通过qcollectiongenerator命令生成的二进制文件,启动Assistant时需要指定collection参数,即qhc文件。qhc文件中是qch文件的集合,打开Assistant时,通过指定当前collection即可注册多个帮助文档。
在编写qhcp文件时,建议采用(4)中的第二种方式,这样只需要一个命令即可生成qch和qhc文件,也避免了因为遗漏qch文件而造成qhc文件错误。
<?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>
(5)生成qhc文件。通过qcollectiongenerator命令生成qhc文件,格式如下:“qcollectiongenerator doc.qhcp -odoc.qhc"。这里doc.qhcp文件输入的qhcp文件,-o表示输出,doc.qhc为生成的qhc文件名称。足球大小球
<?xmlversion="1.0"encoding="utf-8"?>
<QHelpCollectionProjectversion="1.0">
<docFiles>
<register>
<file>doc.qch</file>
QtAssistant是Qt自带的一款可定制、可重新发行的帮助文件浏览器。QtAssistant支持HTML文件,用户可以利用其定制自己的功能强大的帮助文档浏览器。关于QtAssistant定制的资料主要是QtAssistant自身所带的英文文档,虽然讲解比较详细,但是对于初学者来说难以快速的入手。因此结合具体实践,对QtAssistant定制的过程进行整理,希望对他人能有所启发。
从文件中可以看出,只需要在register标签中指定相应的qch文件名称即可。当前这里必须确保在qhcp文件目录下存在指定的qch文件。为了避免因为忘记生成qch文件而造成错误,qhcp中支持通过指定qhp文件从一次生成相应的qch和qhc文件。格式如下:
(6)运行QtAssistant。可以通过命令“qassistant-collectionfiledoc.qhc”打开qassistant,打开后即可浏览到我们自己的帮助文档了。当然如果是在程序中,可以通过QProcess来调用assistant.exe,并给出相应的collectionfile参数即可。
从以上可以看出,在qhcp文件中多了一个<generate>标签,并指定了输入qhp文件,和输出qch文件。文件里面可以指定多个qhp和qch,只要注意好文件直接的对应关系就可以了。
定制过程中用到qhp,qch,qhcp,qhc四种不同格式的文件。对于这四种文件,初学者可能会经常混淆。至少我在开始用的时候,一头雾水。首先讲解一下这四种文件格式。这四种文件可以分为两组:
.....................................................................
<file>Tutorial_files/clip_image072.jpg</file>
</files>
</filterSection>
</QtHelpProject>
展开内容
9.4/869.9M
君王2手游ol是那种西方魔幻题材的冒险游戏,有更多不错的横向设计玩法,创新好玩的系统带给玩家更多的感动,登录就送gm武器,保证大家都会喜欢。、游戏官方介绍《君王...
10.0/818.1M
三星SamHelper是一款全新推出的三星智能测试系统app。这里包含了海量的功能可以使用,帮助你快速的打开工具箱,轻松的进行自定义管理,操作简单,使用方便,根...
9.8/79.3M
沙漠汽车模拟是一款驾驶汽车在沙漠上驰骋的模拟手游,在游戏中玩家将会遇到各种地形的沙漠环境,还能解锁不同型号的汽车,玩起来新鲜感非常强,感兴趣的小伙伴快来uzzf...
8.3/1,645.4M
这游戏正版要在电脑上下,手机版本的官方还是测试开发,目前还不可以玩,没有具体的消息,这个版本是国外的玩家自己自制的私人服,只有一个地图,但是对于手机的配置要求也...
10.0/434.7M
口袋冒险王公测版:趣味性十足的动作冒险游戏,在这款游戏当中有着超级精致的画面,让玩家们在玩的时候可以真实的战斗氛围,而且在游戏开始之后,玩家们可以任意选择战斗职...
8.9/315.2M
小灶答疑app是一款专为中学学生打造的数学作业答疑提分学习工具,名声在线为你视频讲解课堂内容,学校没弄懂的问题都可以在线提问,老师为你一对一解答,每日更新针对性...
查看
8.7/1,441.0M
大哥超变版是一款非常热血的传奇类手游,你将要和兄弟们一起前往传奇沙城,共同抵抗强敌的敌人,在哪里还有大哥成龙在等着你,与你一起爆取强力的装备,激情互砍。三大职业...
查看
8.4/1,545.4M
飞机炸翻天游戏送红包了,游戏玩家将操控一架飞机进行作战,各具特色的僚机在战斗时提供帮助,击落敌人的战机,金币满屏飞,游戏中还有超级丰厚的豪礼每天送不停,赶快来下...
8.0/501.5M
剑罡天下1.0.22初登水域是一款具有挑战性的防守魔兽地图,地图支持1-5人同时在线游戏,最新版地图提高物品爆率,玩法更加刺激。地图说明:地图名称:剑罡天下v1...
8.1/1,740.0M
这是一款绿色小巧的内存整理工具,本系统内核完全采用汇编技术,直接根本的整理系统中的碎片,本软件一直面对国外客户销售,现在推出中文版,免费供国内客户使用。功能特色...
10.0/1,319.7M
博思特游泳馆管理系统是一款实用的针对游泳馆设计的管理软件,这是一套全自动智能管理平台,喜欢的网友可以来东坡网下载!博思特游泳馆管理系统介绍博思特游泳馆管理系统,...
9.7/20.9M
成语猜不停红包版是真的哦,作为全新红包赚钱游戏,在这里玩家完成猜成语,就能解锁大额红包,丰厚福利呢。趣味猜成语,随心所欲自由闯关,积少成多红包解锁,满0.3就可...
9.7/502.2M
NB实验室app是一款专为化学物理实验提供的线上模拟实验室平台,学生可以在这里自己动手操作课程中学到的实验,理论和实践相结合。提供海量的实验学习资源和智能的实验...
9.2/470.8M
大家知道云盘现在可谓是快片的最佳神器咯,怎么去搜索咯,小编为您带来的最新的-网盘搜索ios版,非常不错的东东哟,喜欢就搜索吧!网盘搜索ios版使用方法1、打开软...
8.5/1,863.4M
想要便捷的出行旅游么,现在各种廉价旅游非常的多,想要玩的畅快不知道怎么选择,这款手机旅游出行服务app可以为大家推荐各种旅游线路,帮助你解决一切问题。手机旅游出...
8.6/61.5M
终结将至是由以撒开发商制作的动作类游戏,该游戏画质十分的精致,在游戏中玩家将体验到冒险的乐趣,这里是东坡为大家带来的终结将至汉化补丁,让大家能够更好地体验游戏,...
7.7/171.7M
粤享5Gapp,广东移动量身打造的移动5G综合服务平台。为用户提供5G覆盖查询、5G在线购机、5G套餐订购等功能,还有海量5G视频、VR视频提供,畅享生活,尽在...
查看
7.8/946.2M
人民视频app是由人民网股份有限公司官方联合腾讯、歌华打造的一款视频平台,可以随时的看直播,新闻短视频,用户分享的视频。使用方法首页是热门的内容点击直播按钮即可...
8.9/226.6M
华为手机刷机包是一款专门为华为手机所打造的刷机软件。很多朋友对刷机都不是很了解,这款软件可以帮助你一键刷机,操作非常的简单。小白就可以变大师,需要的朋友快来下载...
9.7/256.1M
捡辆车app是一个支持分期付款的汽车商城,为用户带来了丰富的汽车,还有最新汽车资讯,可以为想要买车的朋友提供参考,了解最新行情!软件介绍汽车新零售的低成本买车服...
9.4/639.8M
琴拿手是一款乐器陪练的软件,里面有全品类的乐器,不管你想要的学习的是什么只要是乐器,我们这里都有专业的老师来帮助你,来鼓励的方式去帮助你去学习,还会写成报告给家...
7.6/1,325.9M
平安万年历APP最新版本是一款比较实用的生活工具类软件,软件包含了日历相关的各种功能,集成了公历、农历、黄历等多种历法,可方便用户进行不同历法之间的对照和查询,...