.....................................................................
<file>Tutorial_files/clip_image072.jpg</file>
</files>
</filterSection>
</QtHelpProject>
QtAssistant是Qt自带的一款可定制、可重新发行的帮助文件浏览器。QtAssistant支持HTML文件,用户可以利用其定制自己的功能强大的帮助文档浏览器。关于QtAssistant定制的资料主要是QtAssistant自身所带的英文文档,虽然讲解比较详细,但是对于初学者来说难以快速的入手。因此结合具体实践,对QtAssistant定制的过程进行整理,希望对他人能有所启发。
(3)生成qch文件。qhp文件完成后,通过qhelpgenerator命令生成压缩的qch文件。打开cmd,输入"qhelpgenerator doc.qhp -odoc.qch"。这里doc.qhp为输入的qhp文件,-o表示输出,输出文件名为doc.qch。
(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"?>
<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>
(1)制作HTML的帮助文件。由于原来的帮助文档是利用Word完成的,因此需要转换。转换的过程十分简单,即便对HTML不了解的用户也可以轻松完成。目前网络上有许多现成的HTML编辑器,利用这些编辑器即可轻松的进行编辑生成相应的html文件。
定制过程中用到qhp,qch,qhcp,qhc四种不同格式的文件。对于这四种文件,初学者可能会经常混淆。至少我在开始用的时候,一头雾水。首先讲解一下这四种文件格式。这四种文件可以分为两组:
(2)qhcp和qhc。qhcp是QtHelpCollectionProject的缩写,其主要作用是将qch二进制文件组织成为一个collection,定制客户化的Assistant;而qhc则是通过qcollectiongenerator命令生成的二进制文件,启动Assistant时需要指定collection参数,即qhc文件。qhc文件中是qch文件的集合,打开Assistant时,通过指定当前collection即可注册多个帮助文档。能赚钱的软件app
(5)生成qhc文件。通过qcollectiongenerator命令生成qhc文件,格式如下:“qcollectiongenerator doc.qhcp -odoc.qhc"。这里doc.qhcp文件输入的qhcp文件,-o表示输出,doc.qhc为生成的qhc文件名称。
从上面文件的解释看,我们需要手动完成两个文件即qhp和qhcp文件,通过这两个文件再生成最终需要的qch和qhc文件。qhp和qhcp文件都是XML文件,语法比较简单,这里不对语法进行详细介绍,具体可查看QtAssistant帮助文档。下面结合我在项目中对Assistant定制的过程进行总结,并给出了用到的qhp和qhcp文件的内容,这样更有助于从整体上对该过程进行把握。
<file>其他的qch文件</file>
</register>
</docFiles>
</QHelpCollectionProject>
在编写qhcp文件时,建议采用(4)中的第二种方式,这样只需要一个命令即可生成qch和qhc文件,也避免了因为遗漏qch文件而造成qhc文件错误。
<?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>
从文件中可以看出,只需要在register标签中指定相应的qch文件名称即可。当前这里必须确保在qhcp文件目录下存在指定的qch文件。为了避免因为忘记生成qch文件而造成错误,qhcp中支持通过指定qhp文件从一次生成相应的qch和qhc文件。格式如下:
(2)编写qhp文件。下面是在项目中用到qhp文件,文件比较简单,这里仅用到了基本的功能,具体语法可以查看帮助文档。这里需要注意的是通过<section>标签指定帮助文档目录,这里可以是多级目录,但是Qt中建议不超过四级。指定目录后,需要通过<file>来指定所有用到的HTML文件,包括HTML文件中用到的所有图片。这里如果不指定,生成的qch文件注册到QtAssistant后将不能找到有效的文件进行显示。
从以上可以看出,在qhcp文件中多了一个<generate>标签,并指定了输入qhp文件,和输出qch文件。文件里面可以指定多个qhp和qch,只要注意好文件直接的对应关系就可以了。

(4)编写qhcp文件。qhcp中主要是对用到的qch文件进行组织,项目中用到的一个简单的qhcp文件如下:
(6)运行QtAssistant。可以通过命令“qassistant-collectionfiledoc.qhc”打开qassistant,打开后即可浏览到我们自己的帮助文档了。当然如果是在程序中,可以通过QProcess来调用assistant.exe,并给出相应的collectionfile参数即可。
展开内容
8.8/744.4M
大型即时战略arpg游戏——妖神山海经传说,主要是以山海经为故事背景,它有着丰富的游戏系统和剧情,三大不同的职业PVP对战玩法,东坡小编附上妖神山海经传说安卓最...
9.9/1,546.8M
非常不错的摄影神器,可以轻松进行拍照,在上面可以看到众多的摄影作品,认识很多拍照摄影爱好者,可以轻松交流一起邀约拍照!去拍摄影怎么样去拍摄影能够高效的向顾客交付...
8.3/323.1M
关于感恩的主题活动有很多,有的幼儿园为了增加家长学生与学校的联系,会举办一些感恩主题的亲子活动。下面小编就和大家介绍一个幼儿园邀请函模板,非常可爱卡通哦,具体是...
8.2/164.7M
钬花教育社区app是一款教育学习软件,这里汇集了众多的老师,学生,有教育直播视频、知识问答、私人课堂等内容,都是爱好学习的朋友大家一起交流。使用方法在首页可以看...
9.0/1,350.4M
依时利门禁是专业性的智能一卡通产品,为了帮助用户更好使用依时利三旺TCP模块设置工具,用户通过这款软件能直接设置参数,操作起来更加便捷。新旧三旺TCP模块区别1...
9.1/1,498.8M
现在出门每一个停车位都是非常的紧俏的,停车王app是一款手机停车软件,能够自动查找周边停车位,实时获得停车场的位置和空余车位,让你找车位不再烦恼,东坡推荐有需要...
8.0/1,852.7M
最近一款割草游戏火了,游戏名:Boomersimulator,本站为您带来了boomersimulator游戏下载,这款游戏为玩家带来了趣味玩法,像素的风格特别...
8.9/733.3M
梦回悟空传官网版是一款西游冒险类型的手游,在这里玩家会有相当多的西游经典角色可以见到,玩家组合好自己的队伍,然后就是开始对战了,精彩的对决对战现在就开始,首先就...
9.6/178.3M
还在为找不到房烦恼吗?万间真实房源尽在安心小窝:专业》专业好房任你随意挑!实时》线上查看附近租房信息,随时掌握各类房屋户型租赁信息全面》合租、整租、分整租…信息...
9.7/330.6M
壹点问诊app是一款非常便捷的手机在线问诊服务平台。它不仅提供了高质量的医疗服务,还为患者提供了更为贴心的服务。通过电子病历单、健康科普等功能,让患者对自己的病...
9.1/543.7M
尚课铃是一家专注于K12教育的互联网科技服务商。致力于提供高效有趣的技术平台,给6-18岁孩子带来优质的在线教学体验和服务。尚课铃app特点学习定制通过尚课铃独...
8.8/1,793.1M
CHKenTrayClock是一个任务栏时间增强工具,可以在任务栏显示星期几。时间格式显示为月/日|星期小时:分钟时间格式使用说明:/=换行 =转义符 c=CP...
8.4/1,297.8M
桌面图标大小异常修复工具是一款使用十分方便的图标大小修复软件,在我们的生活工作中总能遇到图标不小心变大或是变小的状况,用户可以使用桌面图标大小异常修复工具软件进...
9.4/595.0M
阿拉私家app商户端是商家管理自己店铺的神器,通过app可以管理自己的员工,管理客户信息,随时查看自己的订单,功能实用!阿拉私家app介绍阿拉私家,成就绿色家具...
7.6/1,149.8M
猎魂觉醒礼包激活码2020是由网易自研的一款战略级3D团队狩猎手游大作。游戏力求最真实的狩猎,取消了职业限定,玩家可以在多种武器种中自由选择进行狩猎,同时可以使...
7.9/449.5M
一款儿童教育游戏,熊猫老师虫虫大作战,探索奇妙的虫虫世界,大雨了,小虫虫的家被淹没了,玩家要帮助它找一个新家。游戏特色1.丰富可爱的彩蛋道具可以增加与小朋友的互...
8.3/747.8M
脉冲pulsed红包版是款带有音乐节奏感的音乐球球类的游戏,游戏操作起来非常的简单,灵活的控制你的手指有节奏去点击,考验你的节奏感的时刻到了。脉冲pulsed红...
7.5/1,052.4M
儿童数字加减app是一款适用于3-10岁儿童的基础数学和算术学习软件,从认识数字开始,然后到简单的加减法,再搭配趣味小游戏,卡通场景化的设计让儿童轻松快乐的学习...
7.5/1,888.7M
古筝是中国的传统乐器,魔幻古筝将钢琴融入了古筝中,即使你不懂古筝,通过魔幻古筝手把手教你演奏古筝名曲,让你也可以体验古筝乐趣。《魔幻古筝》融合了传统中国水墨画元...
8.4/1,935.3M
安卓exe模拟器是一款模拟器的游戏,玩家可以通过这款游戏来进行模拟游戏,安卓exe模拟器app提供多种系统辅助功能,在手机上运行exe游戏软件安装数据包,就可以...
9.9/700.5M
听着很多小伙伴总是喜嫌往清风网区听歌相当麻烦,这时就可以选择用清风dj网舞曲解析下载工具,它不但能够非常方便的来进行下载,而且下载的歌曲会比在线听更有感觉!清风...
8.1/802.8M
《打击垫大师》是一款手机上的打击垫模拟演奏软件,可自由调节打击垫数量与布局,至多支持8x8即64个打击垫。可为每个打击垫加载各自的音色,使用功能强大的打击垫编辑...
8.2/1,812.0M
重庆挂号网12320服务平台app是一款重庆官方预约挂号平台,是一款最正规的挂号软件,专为在重庆生活的居民打造,可以随时随地在线预约医生,包括了重庆所有的医院,...
9.1/874.9M
开锁帮app是一款公安厅认证的服务平台,为用户带来了便捷的开锁服务,还有丰富的安全百科知识,门锁选购知识!开锁帮app介绍开锁帮服务平台秉承“便民、安民”的服务...
8.7/1,255.5M
这是最近在抖音和微博上都非常火的一个梗,一个非常好用的斗图表情包可以使用,帮助你斗图拿下胜利不成问题,多个模糊表情包可以分享。表情包预览就这就这什么梗就这,是网...