JEP 224:HTML5 Javadoc
概括
增强javadoc
生成HTML5标记的工具。
目标
为标准 doclet 提供一个选项以请求 HTML 4 或 HTML5 输出。 HTML5 标记是语义的,即,将含义与样式和内容清楚地分开。使用 HTML5 标记的标准 doclet 生成的页面部分满足可访问性要求。
非目标
取代生成的 HTML 页面当前的三框架/无框架结构不是目标;这可能是未来 JEP 的主题。
它的目标不是强制在文档注释中使用 HTML5,也不是提供将使用 HTML 4 编写的文档注释转换为 HTML5 的能力。
动机
在 JDK 8 及更早版本中,标准 doclet 在HTML 4.01中生成页面,这是一个旧标准,并且不提供对满足可访问性要求的支持。
HTML5是 HTML 的最新标准。 HTML5 增加了网页的语义价值,使创建可访问的网页变得更加容易。