我们需要编译成QtHelp (.qch和.qhc)。我想知道什么工具/工具链是最容易做到这一点的?我们想要一个WYSIWYG帮助创作工具作为我们的起点,然后运行输出通过所有我们必须得到的QtHelp。
我们过去使用过帮助和手动,这是我们在帮助创作工具中寻找的WYSIWYG接口的类型。但是我们需要工具链来生成简单的html页面(每个帮助主题一个),可以与qhelpgenerator
或qcollectiongenerator
一起使用,以及创建..qhp(至少是目录和关键字部分)和.qhcp来生成..qch和.qhc。我看不出“帮助与手册”是如何适应这一点的。
我们简要地看了一下Sphynx,但是它对于文本格式的选择似乎非常有限。例如,它似乎没有任何方法来改变字体,字体大小,字体颜色等一段文字。实际上,似乎不可能有既粗体又斜体的文本。对于开发人员文档来说,看起来很不错,但似乎缺少了编写用户帮助文件的基本内容。如果我不知何故错过了基本的文本格式功能,请纠正我!
那么,您推荐了什么WYSIWYG帮助创作工具,以及从该工具到..qch和一个.qhc的路径是什么?
发布于 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解决这个问题的一些好处:
再次,如果有人有一个更好的解决方案或改进,请张贴!
发布于 2013-02-06 03:50:05
使用Helpinator 3 Professional,它是generat pdf文件。
发布于 2021-02-19 14:07:08
您可能会考虑使用HelpNDoc帮助创作工具,它有一个WYSIWYG编辑器,可以开箱即用生成Qt帮助文件。生成的源文件可供手动编辑和手动编译使用。
https://stackoverflow.com/questions/5436786
复制相似问题