所见即所得用户帮助创作工具是否与qthelp配合使用？

我们需要编译到QtHelp（.qch和.qhc）。我想知道什么工具/工具链最容易做到这一点？我们想要一个WYSIWYG帮助创作工具作为我们的起点，然后通过任何我们必须获得帮助的方式运行它的输出

我们过去使用过帮助和手册，这就是我们在帮助创作工具中寻找的所见即所得界面。但是我们需要工具链来生成简单的html页面（每个帮助主题一个），我们可以使用

qhelpgenerator

或

qcollectiongenerator

，还需要创建.qhp（至少是目录和关键字部分）和.qhcp来生成.qch和.qhc。我不知道“帮助和手册”如何适用于此

我们简要介绍了Sphynx，但它的文本格式选项似乎非常有限。例如，看起来没有任何方法可以更改一段文本的字体、字体大小、字体颜色等。看起来实际上不可能有粗体和斜体的文本。看起来很适合开发人员文档，但似乎缺少编写用户帮助文件的基本内容。请纠正我，如果我不知何故错过了基本的文本格式功能

---

那么，您建议使用什么WYSIWYG帮助创作工具，以及从该工具到.qch和.qhc的路径是什么？

看起来帮助和手册终究会起作用！这是我们现在看到的序列。如果发现任何问题或改进，请发表意见

在“帮助和手册”（使用版本5.5.1 Build 1296 professional license进行测试）中，在Project Explorer的“配置”部分：

转到HTML页面模板\默认设置。在HTML源代码选项卡中，注释掉该部分

转到“发布选项\ Web帮助”

在布局中，选择无框架、无脚本

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

类似地，目录也是不相关的，除非我们可以控制格式，否则我们必须直接在.qhp中维护toc

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

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

在与.htm相同的文件夹中，我们创建.qhp和.qhcp文件，并运行qcollectiongenerator生成.qhc，然后使用Qt Assistant显示。有关此工具链的Qt侧的帮助，请参阅

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

我们发现使用H&M解决此问题有一些好处：

• 多个文档管理器可以同时工作，并且源代码作为文本文件存储在Subversion中，所以它是可版本的，您可以比较更改
• 轻松创建所见即所得的帮助主题
• 可以处理各种文本格式和链接。例如，在对功能进行端到端测试以查看H&M的哪些功能在我们的最终产品中有效（.qtc在Qt Assistant中查看），我惊讶地看到Qt Assistant甚至处理链接到其他主题/锚的图像中的热点
• qhc被集成到Qt中，因此您可以从Qt应用程序中很好地控制您的帮助

---

同样，如果有人对此有更好的解决方案或改进，请发布

> P>使用HelpPoter 3专业的GM QT JavaAdword PDF文件，很简单.

< P>您可以考虑HelnDoc帮助创作工具，它拥有一个WYSIWYG编辑器，可以跳出框外。可以选择保留生成的源文件以进行手动编辑和手动编译