作用于 Javadoc
工具的 Javaagnet
.
项目和 javadoc
的版本均为 java 17
.
本项目的用途有:
- 补全一部分未被翻译的文本. 补全的内容见 l10n-patch-doclets.properties 和 l10n-patch-standard.properties.
- 为网页资源路径添加版本号, 便于缓存, 提升页面加载速度, 同时确保版本更新时正确加载新版的资源文件.
- 在网页底部插入自定义脚本 (使用
-bottom
参数需要同时加入--allow-script-in-comments
参数, 而这也会允许代码注释中的脚本, 因此选择这种较麻烦的方法).
mvn package
由于 javadoc
命令似乎不支持使用 javaagent
, 需要用 java
命令启动 javadoc
工具.
java -javaagent:javadoc-agent.jar --module jdk.javadoc/jdk.javadoc.internal.tool.Main args...
agent 需要的信息通过环境变量传递, 这些环境变量有:
- VERSION - 版本信息, 通常是某次 git commit id 的缩写.
- L10N_DOCLETS_PATCH_FILE - 译文补丁文件位置, 作用的类为
jdk.javadoc.internal.doclets.toolkit.resources.doclets_zh_CN
. - L10N_STANDARD_PATCH_FILE - 译文补丁文件位置, 作用的类为
jdk.javadoc.internal.doclets.formats.html.resources.standard_zh_CN
. - BOTTOM_SCRIPT_FILE - 自定义脚本的文件名, 此脚本应位于生成的 javadoc 的根目录下.