首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >问答首页 >所见即所得用户帮助创作工具使用qthelp?

所见即所得用户帮助创作工具使用qthelp?
EN

Stack Overflow用户
提问于 2011-03-25 18:46:34
回答 3查看 763关注 0票数 0

我们需要编译成QtHelp (.qch和.qhc)。我想知道什么工具/工具链是最容易做到这一点的?我们想要一个WYSIWYG帮助创作工具作为我们的起点,然后运行输出通过所有我们必须得到的QtHelp。

我们过去使用过帮助和手动,这是我们在帮助创作工具中寻找的WYSIWYG接口的类型。但是我们需要工具链来生成简单的html页面(每个帮助主题一个),可以与qhelpgeneratorqcollectiongenerator一起使用,以及创建..qhp(至少是目录和关键字部分)和.qhcp来生成..qch和.qhc。我看不出“帮助与手册”是如何适应这一点的。

我们简要地看了一下Sphynx,但是它对于文本格式的选择似乎非常有限。例如,它似乎没有任何方法来改变字体,字体大小,字体颜色等一段文字。实际上,似乎不可能有既粗体又斜体的文本。对于开发人员文档来说,看起来很不错,但似乎缺少了编写用户帮助文件的基本内容。如果我不知何故错过了基本的文本格式功能,请纠正我!

那么,您推荐了什么WYSIWYG帮助创作工具,以及从该工具到..qch和一个.qhc的路径是什么?

EN

回答 3

Stack Overflow用户

回答已采纳

发布于 2011-04-13 21:29:58

看来帮助和手册终究会起作用的!这是我们现在要看的序列。如果您看到任何问题或改进,请评论。

在“帮助和手册”(使用5.5.1版Build 1296专业许可证进行测试)中,在Project中,在Configuration部分:

进入HTML页面模板\默认。在“HTML源代码”选项卡中,注释掉该部分。

转到发布选项\Web帮助。

在“布局”中,选择“没有框架,没有脚本”。

在导航中,我们不需要任何检查--尽管如果有一种方法可以控制KEYWORD_INDEX值的格式以便我们可以直接复制和粘贴到我们的.qhp中,那就太好了!我还没有找到这样的方法,所以我们计划在.qhp中直接维护关键字。

类似地,目录也是不相关的,除非我们能够控制格式,我们必须在.qhp中直接维护toc。

在弹出主题中,我们被设置为HTML编码的主题。不确定这是否有必要。

这就是我们要改变的所有设置。正常地在H&M中创建帮助内容,然后发布Webhelp。这将为每个主题创建一个单独的.htm文件。

在与..htm相同的文件夹中,我们创建.qhp和.qhcp文件,并运行qcollectiongenerator生成.qhc,然后使用Qt显示该文件。有关这个工具链的Qt端的帮助,请参见http://doc.qt.nokia.com/4.7/qthelp-framework.html

同样,如果我们能够找到一种方法来设置H&M,以.qhp所需的格式创建toc和关键字,并且我们只需将它们粘贴到.qhp中(或者为此,也可以在模板中维护.qhp ),那就太好了。另一种选择是编写脚本,将H&M为toc和关键字创建的内容转换为.qhp所需的内容。如果你这样做,不介意分享,请张贴代码!

我们发现使用H&M解决这个问题的一些好处:

  • 多个文档可以同时工作,源作为文本文件存储在Subversion中,因此它是可验证的,您可以比较更改。
  • 轻松创建帮助主题
  • 能够处理各种文本格式和链接。例如,在对特性进行端到端测试以查看H&M的哪些特性将在我们的最终产品(中查看.qhc)时,我惊讶地看到Qt助手甚至处理链接到其他主题/锚的图像中的热点。
  • .qhc集成到Qt中,因此您可以从Qt应用程序中很好地控制您的帮助。

再次,如果有人有一个更好的解决方案或改进,请张贴!

票数 0
EN

Stack Overflow用户

发布于 2013-02-06 03:50:05

使用Helpinator 3 Professional,它是generat pdf文件。

票数 0
EN

Stack Overflow用户

发布于 2021-02-19 14:07:08

您可能会考虑使用HelpNDoc帮助创作工具,它有一个WYSIWYG编辑器,可以开箱即用生成Qt帮助文件。生成的源文件可供手动编辑和手动编译使用。

票数 0
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/5436786

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档