我正在尝试将可搜索的帮助集成到我的 Java (Swing) 应用程序中。我现在正在使用 docbook 来生成 pdf 帮助，并且我知道它可以生成 JavaHelp。我认为 JavaHelp 的默认查看器相当不吸引人（尤其是在 Windows 上，即使在使用 Windows L&F 时也是如此）。我找不到任何好看的查看器，但很好奇您是否知道那里有任何查看器，或者在应用程序中是否有更好的帮助替代方案。
问问题
3238 次
2 回答
5
JavaHelp中的默认内容查看器（HTML 渲染器）是HTMLEditorKit。这个组件不是很令人印象深刻；它仅支持 HTML 3.2 并且具有有限的 CSS 功能。可以在 JavaHelp中插入替代内容查看器。
您可能想尝试Oracle 帮助。它与 JavaHelp 非常相似，但更积极地维护。Oracle 帮助附带的默认内容查看器功能也更强大。DocBook-XSL JavaHelp 样式表可能需要进行一些调整才能生成与 Oracle 帮助一起使用的输出（请参阅此页面）。
很难找到有关这些技术的状态和未来计划的确切信息。JavaHelp 于 2007 年 10 月发布了最新版本，而 Oracle Help 11.1.2.1.0 于 2011 年 9 月发布。有论坛（这里和这里），但活跃度很低。
也许您会对基于 Web/浏览器的帮助系统感兴趣。在这种情况下，请查看WebHelp，它是 DocBook 内容的一种较新的输出格式。
于 2012-04-10T11:07:19.060 回答
2
我一直在使用Sphinx来满足我的所有文档需求，它具有出色的 HTML 模板。sphinx 站点本身基于其中一个模板。还有一个eclipse 插件可以帮助您设置基础 sphinx 项目并充当编辑器。好处
- 您使用类似于 wiki 的 ReST 语法编写文档。
- 好看的html模板/
- 能够生成其他格式，如 epub、pdf 等。
- 可版本化
于 2012-03-28T01:53:00.900 回答