java - 在 javadoc 中添加链接到谷歌代码上的源文件

Question

我从事一个托管在谷歌代码上的开源项目。我正在使用 ant 来创建 javadoc，并且我想要链接到源文件。我知道我可以使用 linksource flag to javadoc在生成的 html 中包含源代码，但这不是我真正想要的。我更喜欢在谷歌代码的 svn 浏览器中提供源文件的链接。我想我可以在运行 javadoc 之前做一个简单的过滤器，但如果我能想出一种在 javadoc 中正确执行此操作的方法，那就更好了。理想情况下，我可以在我的 ant 属性文件中拥有一个属性，例如

base.src.url=http://code.google.com/p/myproject/source/browse/branches/1.2

javadoc 命令会在每个类的 html 文件中添加一行:

<a href="http://code.google.com/p/myproject/source/browse/branches/1.2/[package]/[classname].html">see source on google code</a>

有什么想法吗？

Answer 1

据我所知，标准 doclet 没有提供这样的选项。所以看起来你要么必须

• 使用替代的 doclet，
• 修补标准 doclet，
• 预处理 Java 文件或
• 对生成的 HTML 进行后处理。

将其包含在标准 doclet 中的功能请求也可能是个好主意。