Javahelp查看器（或替代品）

Question

我正在尝试将可搜索的帮助集成到我的Java（Swing）应用程序中。我现在正在使用docbook生成pdf帮助，我知道它可以生成JavaHelp。我认为JavaHelp的默认查看器相当没有吸引力（特别是在Windows上，即使使用Windows L＆amp; F）。我找不到任何漂亮的观众，但如果你知道那里的任何一个，或者在应用程序中有更好的替代帮助，我会很好奇。

Answer 1

JavaHelp中的默认内容查看器（HTML呈现器）为HTMLEditorKit。这个组件不是很令人印象深刻;它只支持HTML 3.2并且具有有限的CSS功能。可以插入alternative content viewers in JavaHelp。

您可能想尝试Oracle Help。它与JavaHelp非常相似，但更积极地维护。 Oracle Help附带的默认内容查看器也更强大。 DocBook-XSL JavaHelp样式表可能需要进行一些调整才能生成适用于Oracle Help的输出（参见this page）。

很难找到有关这些技术的状态和未来计划的确切信息。 JavaHelp于2007年10月发布了最新版本，而Oracle Help 11.1.2.1.0于2011年9月发布。有论坛（here和here），但活动很少。

也许您对基于Web /浏览器的帮助系统感兴趣。在这种情况下，请查看WebHelp，这是DocBook内容的一种较新的输出格式。

Answer 2

我一直在使用Sphinx来满足我的所有文档需求，并且它具有出色的HTML模板。狮身人面像网站本身基于其中一个模板。还有eclipse plugin可以帮助您设置基本的sphinx项目并充当编辑器。优点

1. 您使用与wiki类似的ReST语法编写文档。
2. 好看的html模板/
3. 能够生成其他格式，如epub，pdf等。
4. 版本可控