2011-03-25 102 views
0

我们需要编译为QtHelp(.qch和.qhc)。我想知道什么工具/工具链对此最简单?我们希望所见即所得的帮助创作工具作为我们的出发点,然后通过无论我们必须获得的QtHelp来运行输出。wysiwyg用户帮助创作工具与qthelp一起工作?

我们已经在过去使用过帮助&手册,这就是我们在帮助创作工具中寻找的所见即所得界面。但是我们需要工具链生成简单的html页面(每个帮助主题一个),我们可以使用qhelpgeneratorqcollectiongenerator,以及创建.qhp(至少包含目录和关键字部分)和.qhcp以生成.qch和.qhc。我没有看到如何帮助手册可以适应此。

我们简单看了斯芬克斯,但它似乎有非常有限的文本格式选项。例如,它看起来没有任何方法可以更改文本部分的字体,字体大小,字体颜色等。看起来实际上不可能有粗体和斜体的文本。看起来非常适合开发人员的文档,但似乎缺少编写用户帮助文件的基本内容。如果我错过了基本的文本格式功能,请纠正我的错误!

那么,你推荐什么所见即所得的帮助创作工具,那个工具到.qch和.qhc的路径是什么?

回答

0

看起来像帮助和手册将工作毕竟!这是我们现在看的顺序。如果您发现有任何问题或可以改进的地方,请点评。

在帮助&手册(与版本5.5.1构建1296专业执照测试),在项目资源管理器,在配置部分:

转到HTML页面模板\默认。在HTML源代码标签中,注释掉该部分。

转到发布选项\ Web帮助。

在布局中,选择无框架,无脚本。

在导航中,我们不需要任何检查 - 虽然如果有一种方法可以控制KEYWORD_INDEX值的格式,以便我们可以直接复制并粘贴到我们的.qhp中,那太棒了!我还没有找到办法做到这一点,所以我们打算直接在.qhp中维护关键字。

同样,目录也是不相关的,除非我们可以控制格式,我们必须直接在.qhp中维护toc。

在Popup Topics中,我们设置为HTML编码主题。不知道这是否有必要。

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

在与.htm相同的文件夹中,我们创建了.qhp和.qhcp文件,然后运行qcollectiongenerator生成我们的.qhc,然后使用Qt Assistant显示.qhc。请参阅http://doc.qt.nokia.com/4.7/qthelp-framework.html以获取此工具链Qt一侧的帮助。

如果我们能够找到一种方法来设置H & M以创建toc和关键字所需的格式,那将是一件好事。qhp,我们可以将它们粘贴到.qhp中(或者也可以在该模板中保存.qhp)。另一个选择是编写一个脚本,以便将创建的tooc和关键字的内容转换为.qhp所需的内容。如果你这样做,不介意分享,请发布代码!

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

  • 多资料员可同时工作,并且源存储在Subversion中的文本文件,所以它是多版本,你可以比较的变化。
  • 易所见即所得创建帮助主题
  • 可以处理各种文本格式和链接。例如,在对功能进行端到端测试以查看H & M的哪些功能可用于我们的最终产品(在Qt助手中查看.qhc)时,我惊讶地发现Qt Assistant甚至在图像链接中处理热点到其他主题/主播。
  • .qhc已集成到Qt中,因此您可以很好地控制Qt应用程序中的帮助。

再一次,如果有人对此有更好的解决方案或改进,请发布!

0

使用Helpinator 3 Professional它是generat chm qt javahelp word pdf文件easly ..