我在我们公司开发了一个 Maven 报告插件,用于内部使用。它被设计为独立模式,这样可以针对给定的项目运行,而不必在 pom 的
然而,该文档的格式目前是 xhtml,而我们所有的项目文档都存储在 Confluence 上。将文档生成为 Confluence 标记语言将非常方便。已经存在
我目前采取的方法是:
最后,我想记录一下 Maven 的 API 文档真是糟糕透顶。我不需要手把手的教程,只需要一些基本的 javadocs 和一些有见地的评论就足以帮助我完成这个代码库的任何工作了。
<reporting>
部分进行配置。然而,该文档的格式目前是 xhtml,而我们所有的项目文档都存储在 Confluence 上。将文档生成为 Confluence 标记语言将非常方便。已经存在
ConfluenceSink
和ConfluenceSinkFactory
类来生成正确的标记语言,但我没有看到明显的方法来设置AbstractMavenReport
子类使用的 sinks。我目前采取的方法是:
- 重写
execute
方法,因为它目前硬编码了使用SiteRendererSink
,该 sink 输出 xhtml。 - 查找替代
SiteRenderer.generateDocument()
的方法,因为此方法需要上述SiteRendererSink
。
最后,我想记录一下 Maven 的 API 文档真是糟糕透顶。我不需要手把手的教程,只需要一些基本的 javadocs 和一些有见地的评论就足以帮助我完成这个代码库的任何工作了。