为 Java 应用程序维护多种形式的用户指南 [关闭]答案

【问题标题】：Maintaining multiple forms of user guide for a Java application [closed]为 Java 应用程序维护多种形式的用户指南 [关闭]
【发布时间】：2011-08-03 14:29:58
【问题描述】：

我有我的应用程序的用户指南，我想提供 HTML 版本和 PDF 版本（可能还有一些其他索引版本以获得 Java 帮助）。是否有任何工具，最好是用于 maven 的工具，我可以集成到我的构建周期中，将 HTML 转换为 PDF？目前我有一个 word doc 格式，我手动将其转换为 PDF（并且没有可用的 HTML 版本），这很容易出错，而且真的很痛苦。

【问题讨论】：

标签： java html pdf documentation

【解决方案1】：

好吧，经过短暂的搜索后，我继续搜索http://www.xhtml2pdf.com/，如果您有 HTML，它就可以解决问题。

但是，我更喜欢使用 wiki 来获取文档。它具有所有优点，因为它可以以多种语言并行编辑，并且其中很多都具有静态 HTML 导出和 PDF 导出。我应该向您推荐 Dokuwiki（您可以在 http://www.dokuwiki.org/plugins 找到您的插件），因为它非常易于安装和管理，但您也可以使用任何其他具有 PDF 和 HTML 导出功能的插件。

【讨论】：

谢谢，我一定会更详细地了解这些工具，但以防万一我想转至 PDF 以外的其他形式，DocBook 似乎更灵活一些。跨度>

【解决方案2】：

您可以使用DocBook 之类的工具并以脚本语言（在他们的情况下为 XML）编写文档。然后使用该工具将源转换为目标格式，例如HTML 和 PDF。

【讨论】：

我认为这是更灵活的解决方案。谢谢。