【发布时间】:2019-01-30 05:16:18
【问题描述】:
我一直在使用JavaDocs for JDK 11
但我注意到 iFrames 视图似乎不再可用。 我环顾四周,但看不到任何关于为什么这样做的详细信息,如果有的话,还有什么替代方案?谁能提供更多细节?
适用于 JDK 10 的视图
适用于 JDK 11 的视图
【问题讨论】:
我一直在使用JavaDocs for JDK 11
但我注意到 iFrames 视图似乎不再可用。 我环顾四周,但看不到任何关于为什么这样做的详细信息,如果有的话,还有什么替代方案?谁能提供更多细节?
适用于 JDK 10 的视图
适用于 JDK 11 的视图
【问题讨论】:
如果其他人有相同的查询,默认情况下不再生成帧。
JDK-8202961 对此进行了介绍
过去,为了允许在 API 文档中导航,标准 doclet 在窗口左侧的框架中显示索引,以允许选择类、包和(最近的)模块以显示在窗户。
最近,doclet 现在支持“搜索”功能,它提供了一种更通用的方式来查找要查看的项目。另外,doclet 正朝着(仅)使用 HTML 5 的方向发展,HTML 5 中对框架的基本支持比 HTML 4 中的要少。
和JDK-8187794 等等
更新 javadoc/doclet 以默认不生成帧。如果指定“--frames”选项来生成帧,则应生成警告。未来版本中将移除对框架的支持。
似乎如果你真的想使用框架,你可以从 JDK src 生成你自己的框架并体验警告,但这将在某个时候完全删除。
总之,习惯了 Search 功能,框架化的 javadocs 即将被淘汰!
【讨论】:
我创建了JANITOR – Java API Navigation Is The Only Rescue:
将模块、包和类型(接口、类、枚举、异常、错误、注释)的导航树插入到 Java 11+ 的 Javadoc 页面中。
【讨论】:
如果您更喜欢带有 HTML iframe 的 Java 10 及更早版本的 API 文档布局,那么您可能需要查看:https://github.com/climber09/Javadoc-Frames-Generator。这是一项正在进行的工作,所以我欢迎任何反馈。
【讨论】: