qtassistant是啥文件

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了qtassistant是啥文件相关的知识,希望对你有一定的参考价值。

qtassistant也就是我们常说的Qt助手,是一款用于呈现在线文档的工具。

QtAssistant工作原理类似于一个Web浏览器,如果点击一个超链接(交叉引用),文档窗口将显示相应的页面,可以通过点击工具栏中的Back和Forward按钮来切换访问过的页面。

QtAssistant可以像一个Web浏览器一样来浏览文档,拥有Web浏览器并不拥有的强大导航能力。QtAssistant采用了先进的全文搜索引擎来索引每个压缩的帮助文件的所有网页,以便可以搜索特定的单词和短语。

要进行索引搜索,在”查找”输入框中输入要查找的内容,键入以后,下方列表中就会突出显示所有的匹配结果,如果高亮显示文本与你地搜索相匹配,双击(或按Enter键),文档窗口将显示相关页面。在找到匹配信息之前,最好不要搜索整个单词。注意,对于一些单词可能存在多个相关的网页。

QtAssistant还提供了全文搜索查找文档中的特定词语。要激活全文搜索,点击侧边栏的搜索选项卡(或按Alt+S)。然后输入要查找的词并点击搜索按钮,所有包含指定词的文档将被列在下面的列表框中。

扩展资料:

Qt库文档是由开发者自己在线在cpp中所写,文档团队修正的文档以确保它是准确和可用的,并提供产品质量的控制。该文档团队还写了大量的文本,如类描述-介绍类与类使用的概念,以及类提供的功能和属性。

该文档的重点是API,而不是内部结构,因为需要努力保持API相一致,并与每一个新版本兼容。但可以改变内部结构大大提高性能和增强功能。

Qt参考文档包括近1500个html页面(超过2500打印页)。绝大多数的页面文件Qt类。由于开发人员的思考和工作方式不同,所以提供了多种方法来进行文档导航。

参考资料:百度百科-文档

参考技术A 很显然你的qt库里面缺少QtNetwork4.dll这个动态库呀 这个原因就很多啦 比如编译没编好 或者本身源码里面就没有这个库 其实助手这个东西咱们一般都在windows上用 你在windows上装个QTCreater集成环境 什么都就有了本回答被提问者采纳

基于Qt Assistant制作软件帮助文档

Qt Assistant是Qt自带的一款可定制、可重新发行的帮助文件浏览器。Qt Assistant支持HTML文件,用户可以利用其定制自己的功能强大的帮助文档浏览器。关于Qt Assistant定制的资料主要是Qt Assistant自身所带的英文文档,虽然讲解比较详细,但是对于初学者来说难以快速的入手。因此结合具体实践,对Qt Assistant定制的过程进行整理,希望对他人能有所启发。

技术分享图片
       定制过程中用到qhp,qch,qhcp,qhc四种不同格式的文件。对于这四种文件,初学者可能会经常混淆。首先讲解一下这四种文件格式。这四种文件可以分为两组:

      (1)qhp与qch。qhp是Qt Help Project的缩写,qch是Qt Compressed Help的缩写。qhp文件负责组织实际用到的帮助文件(通常为HTML文件,即需要在Qt Assistant中浏览的文件),然后通过qhelpgenerator命令生成压缩的qch文件。qch文件是Qt Assistant能够识别的文档最小单元,可以通过Qt Assistant->编辑->首选项->文档标签页->添加/移除操作来注册或者注销一个qch文件。也可以通过命令“assistant -register doc.qch”来注册qch文件。注册后,即可在Assistant界面中浏览帮助文档。

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

从上面文件的解释看,我们需要手动完成两个文件即qhp和qhcp文件,通过这两个文件再生成最终需要的qch和qhc文件。qhp和qhcp文件都是XML文件,语法比较简单,这里不对语法进行详细介绍,具体可查看Qt Assistant帮助文档。下面结合我在项目中对Assistant定制的过程进行总结,并给出了用到的qhp和qhcp文件的内容,这样更有助于从整体上对该过程进行把握。
下面就是制作步骤:
   (1)制作HTML的帮助文件。HTML文件就是把你需要阐述的内容用很多HTML文件表述出来。比如说我的如下图所示:image文件夹用来存放帮助文档需要使用的所有图片,其他html文件就是阐述的内容:
技术分享图片
   (2)编写qhp文件。下面是在项目中用到qhp文件,文件比较简单,这里仅用到了基本的功能,具体语法可以查看帮助文档。这里需要注意的是通过标签指定帮助文档目录,这里可以是多级目录,但是Qt中建议不超过四级。指定目录后,需要通过来指定所有用到的HTML文件,包括HTML文件中用到的所有图片。这里如果不指定,生成的qch文件注册到Qt Assistant后将不能找到有效的文件进行显示。我的qph文件如下所示:

点击(此处)折叠或打开

  1. <?xml version="1.0" encoding="GB2312"?>
  2. <QtHelpProject version="1.0">
  3.   <namespace>bookmisClient.helpDoc</namespace>
  4.   <virtualFolder>doc</virtualFolder>
  5.   <filterSection>
  6.     <toc>
  7.       <section title="首页" ref="./index.html">
  8.         <section title="用户登录" ref="./userlogon.html"></section>
  9.           <section title="书籍查询" ref="./bookquery.html"></section>
  10.           <section title="续借书籍" ref="./Renewal.html"></section>
  11.      <section title="系统管理" ref="./systemmanage.html"></section>
  12.      <section title="日志管理" ref="./log.html"></section>
  13.      <section title="关于" ref="./about.html"></section>
  14.         </section>
  15.     </toc>
  16.     <files>
  17.       <file>index.html</file>
  18.       <file>userlogon.html</file>
  19.       <file>bookquery.html</file>
  20.       <file>Renewal.html</file>
  21.       <file>systemmanage.html</file>
  22.       <file>log.html</file>
  23.       <file>about.html</file>
  24.       <file>image/*.png</file>
  25.     </files>
  26.   </filterSection>
  27. </QtHelpProject>
       (3)生成qch文件。qhp文件完成后,通过qhelpgenerator命令生成压缩的qch文件。打开cmd,输入" qhelpgenerator   helpDoc.qhp  -o helpDoc.qch "。这里helpDoc.qhp为输入的qhp文件,-o表示输出,输出文件名为helpDoc.qch。如果你的.qch文件在其它文件夹,在输入命令的时候需要加入.qch文件所在目录,同时HTML文件也必须在此目录下:比如所我的:
技术分享图片
      (4)编写qhcp文件。qhcp中主要是对用到的qch文件进行组织,项目中用到的一个简单的qhcp文件如下:我的helpDoc.qhcp:

点击(此处)折叠或打开

  1. <?xml version="1.0" encoding="GB2312"?>
  2. <QHelpCollectionProject version="1.0">
  3. <assistant>
  4.   <title>图书管理客户端帮助文档</title>
  5.   <applicationIcon>image/lib.png</applicationIcon>
  6.   <cacheDirectory>cache/helpDoc</cacheDirectory>
  7.   <homePage>qthelp://bookmisClient.helpDoc/doc/index.html</homePage>
  8.   <startPage>qthelp://bookmisClient.helpDoc/doc/index.html</startPage>
  9.   <aboutMenuText>
  10.     <text>关于</text>
  11.   </aboutMenuText>
  12.   <aboutDialog>
  13.     <file>./about.txt</file>
  14.     <icon>image/lib.png</icon>
  15.   </aboutDialog>
  16.   <enableDocumentationManager>false</enableDocumentationManager>
  17.   <enableAddressBar>false</enableAddressBar>
  18.   <enableFilterFunctionality>false</enableFilterFunctionality>
  19. </assistant>
  20. <docFiles>
  21.   <generate>
  22.     <file>
  23.       <input>helpDoc.qhp</input>
  24.       <output>helpDoc.qch</output>
  25.     </file>
  26.   </generate>
  27.   <register>
  28.     <file>helpDoc.qch</file>
  29.   </register>
  30. </docFiles>
  31. </QHelpCollectionProject>
从以上可以看出,在qhcp文件中多了一个标签,并指定了输入qhp文件,和输出qch文件。文件里面可以指定多个qhp和qch,只要注意好文件直接的对应关系就可以了。

(5)生成qhc文件。通过qcollectiongenerator命令生成qhc文件,格式如下:“qcollectiongenerator    helpDoc.qhcp  -o helpDoc.qhc "。这里helpDoc.qhcp文件输入的qhcp文件,-o表示输出,helpDoc.qhc为生成的qhc文件名称。此编译也需要注意目录问题:我编译的截图:
技术分享图片


(6)运行Qt Assistant。可以通过命令“assistant -collectionfile helpDoc.qhc”打开assistant,打开后即可浏览到我们自己的帮助文档了。当然如果是在程序中,可以通过QProcess来调用assistant.exe,并给出相应的collectionfile参数即可。命令运行:
技术分享图片
帮助文档:
技术分享图片

最后在QT Creator里就可以调用此帮助文档,具体实现可参考下面的下载:
http://download.csdn.net/detail/rojian2010/5353368

https://blog.csdn.net/u014213012/article/details/54318137

以上是关于qtassistant是啥文件的主要内容,如果未能解决你的问题,请参考以下文章

发布利用 Qt Assistant来做帮助系统的程序遇到的问题

Android 逆向ART 脱壳 ( DexClassLoader 脱壳 | oat_file_assistant.cc 中涉及的 oat 文件生成流程 )

如何让 Visual Assist 解析 Pro*C (*.pc) 文件?

飘云阁 怎样彻底卸载飘云阁visual assist

Qt的Q_UNUSED()函数的功能

vc6.0 自动提示 不安装Visual Assist,VC6.0有木有自带代码提示功能,怎么不好使,感觉安装Visual Assist