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

(2)qhcp和qhc。qhcp是QtHelpCollectionProject的缩写,其主要作用是将qch二进制文件组织成为一个collection,定制客户化的Assistant;而qhc则是通过qcollectiongenerator命令生成的二进制文件,启动Assistant时需要指定collection参数,即qhc文件。qhc文件中是qch文件的集合,打开Assistant时,通过指定当前collection即可注册多个帮助文档。
展开

超速扫描王免费下载-超速扫描王app1.0安卓版
81建军节ppt模板下载-2017年八一建军节ppt模板免费版
东海党员志愿者下载-党员志愿者app2.0 安卓手机版
消费者权益日活动策划书-2016年3.15消费者权益日活动方案doc格式【word版】
里诺仓库管理软件(单机版)3.70 注册机
掌上蚁集app下载-掌上蚁集软件1.0.12手机版
瑞雪花图果盘版下载-瑞雪花图果盘客户端11.0.0 官方版
智美光膜app下载-美丽策智美光膜软件1.5.6 官方安卓版
朵朵街app下载-朵朵街1.0 安卓版
长安知音伙伴app下载-长安知音伙伴app4.2.0 官网最新版
圣地的黄昏1.1.6地图下载-圣地的黄昏1.1.6正式版附攻略和隐藏英雄密码
爱乐奇家长端下载-爱乐奇家长端app2.6.3 安卓版
射雕英雄传折扣版1.7.0 安卓最新版
斑马英语app学生版3.27.0 ios苹果版
王者知道长安篇题库答案完整版-2018王者知道第三期长安篇题库及答案大全doc免费版
救援直升机模拟器游戏下载-救援直升机模拟器手游1.91 安卓版
暗黑赛罗眼镜模拟器游戏下载-暗黑赛罗眼镜模拟器1.0 安卓版
快爆手游app下载安装-快游快爆app(好游快爆)1.5.7.807 官方手机版
自动回复软件下载-小蝶自动回复机器人5.2.1.3908 最新免费版
Origin橘子游戏平台客户端-Origin橘子平台10.5.3.59240官方最新中文版