我可以使用什么来创建 html page-per-chapter/monolithic-page/pdf 参考手册？ [关闭]答案

【问题标题】：What can I use to create html page-per-chapter/monolithic-page/pdf reference manual? [closed]我可以使用什么来创建 html page-per-chapter/monolithic-page/pdf 参考手册？ [关闭]
【发布时间】：2010-07-27 11:07:36
【问题描述】：

我想为一个项目编写参考手册，并且我想将它作为 HTML 每章一页的手册（可选单单页将是也不错）和 PDF 版本。

主要例子：

Gentoo 手册 (html one page per chapter, html monolithic)
Netty 的用户指南（html one page per chapter、html monolithic、pdf）
Spring 的参考文档（html、pdf）

我可以用什么来实现这一点？

【问题讨论】：

标签： html pdf documentation reference manual

【解决方案1】：

HTMLDOC.

HTMLDOC 接受一个或多个文件的 HTML 输入，并将输入转换为 PostScript、PDF 或索引 HTML。除非您需要完整的 CSS 支持，否则对于您想要完成的类型工作来说，这是一个很好的工具。你会...

...在 HTML 和
...然后在 HTMLDOC 的帮助下根据需要转换为 PDF 或索引 HTML。

AFAIK，LDP（Linux 文档项目）以这种方式生成 PDF。

（我相信您已经调查过 netty.pdf 和 spring-reference.pdf 是如何生成的（jDocBook Maven 插件 和 FOP/apache），所以我不会添加任何关于这些的细节。

【讨论】：

实际上我在使用 jdocbook-plugin 时遇到了一些困难......我是 maven 的新手，他们的页面在文档上非常稀缺，我还没有找到操作方法。所以，是的，你可以在这些上添加很多细节:)

【解决方案2】：

它是 docbook + maven 插件 (maven-jdocbook-plugin)。

这个pom 包含一个示例，说明如何生产我最初想要的东西。

结果可以在here找到。

还有一个替代方案（仍在使用 docbook 和 maven）docbkx-tools。

【讨论】：

将我自己的答案标记为正确感觉如此......错误^^