如何生成带有变音符号的 javadoc 文档？

Question

我正在尝试在 Eclipse 中生成 Java 文档。源文件采用 UTF-8 编码，并包含一些元音变音。生成的 HTML 文件不指定编码，也不使用 HTML 实体，因此元音变音在任何浏览器中都无法正确显示。

我可以做什么来改变这种情况？

Answer 1

修改自 UTF-8 格式的 Eclipse javadoc：

项目->生成Javadoc ->下一步->在最后一页的“Extra Javadoc options”中写入：

-encoding UTF-8 -charset UTF-8 -docencoding UTF-8

Answer 2

请参阅 -charset、-encoding 和 -docencoding 标志 javadoc 命令。

• -encoding 指定输入编码
• -docencoding 指定输出编码
• -charset 使 javadoc 包含带有编码信息的元标记

Answer 3

如果您使用 ant 任务生成 javadoc 并且使用 UTF-8，您可以执行以下操作：

<javadoc encoding="UTF-8" charset="UTF-8" docencoding="UTF-8" sourcepath="yoursources" destdir="yourdocdir" />

Answer 4

使用 Gradle 生成 javadoc 时，将以下内容添加到您的 build.gradle 文件中：

javadoc {
    options.encoding = 'UTF-8'
    options.docEncoding = 'UTF-8'
    options.charSet = 'UTF-8'
}