Javahelp查看器(或替代方案)

Question

我正在尝试将可搜索的帮助集成到Java (Swing)应用程序中。我现在正在使用docbook来生成pdf帮助，我知道它可以生成JavaHelp。我认为JavaHelp的默认查看器并不吸引人(尤其是在windows上，甚至在使用windows L&F时)。我找不到任何好看的查看器，但很好奇你是否知道有这样的查看器，或者在应用程序中是否有更好的帮助选择。

Answer 1

JavaHelp中的默认内容查看器(HTML呈现程序)是HTMLEditorKit。这个组件给人的印象并不是很深刻；它只支持HTML3.2，并且CSS功能有限。插入alternative content viewers in JavaHelp是可能的。

你可能想试试Oracle Help。它非常类似于JavaHelp，但更积极地维护。Oracle帮助附带的默认内容查看器功能也更强大。可能需要对DocBook-XSL样式表进行一些调整，以便生成可与JavaHelp帮助一起使用的输出(请参阅this page)。

很难找到关于这些技术的现状和未来计划的明确信息。JavaHelp在2007年10月发布了最新版本，而Oracle Help 11.1.2.1.0是在2011年9月发布的。虽然有论坛(here和here)，但活跃度很低。

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

Answer 2

我一直在使用Sphinx来满足我所有的文档需求，它有很好的超文本标记语言模板。sphinx站点本身就是基于其中一个模板的。还有eclipse plugin可以帮助您设置基本的sphinx项目，并充当编辑器。优势

1. 您可以使用类似于维基的ReST语法来编写文档。
2. 漂亮的html templates/
3. Ability可以生成其他格式，如epub、pdf etc.
4. Versionable