将多个模块的 Javadoc 合并到一个集合中

Question

我有一个由几个模块组成的 Java 应用程序。我想为所有这些一起生成Javadoc：也就是说，从这几个模块中，我想要一个带有单个index.html、单个allclasses-frame.html等的HTML文件集合以及各种超链接应该跨模块工作。

我使用 Maven，但不一定限于特定于 Maven 的解决方案。这将由 cron 作业执行，因此也可以使用其他工具。

在这种情况下，自动生成 Javadoc 最直接的方法是什么？

Answer 1

如果您可以管理它，javadoc 可以生成组合文档，前提是您组合输入源。也许有更优雅的解决方案；但是，为什么不将所有源复制到一个组合树中，然后运行javadoc？

另一个选项是使用-link 选项并让一个站点的文档引用另一个站点的文档。请注意，如果您选择此选项，您可能还需要查看 linkoffline 选项，以提高您的 javadoc 构建的灵活性（除非您设法在后续构建需要文档之前以正确的顺序将文档部署到 Web 服务器）。