【问题标题】:Missing iFrame view for Javadocs JDK 11+Javadocs JDK 11+ 缺少 iFrame 视图
【发布时间】:2019-01-30 05:16:18
【问题描述】:

我一直在使用JavaDocs for JDK 11

但我注意到 iFrames 视图似乎不再可用。 我环顾四周,但看不到任何关于为什么这样做的详细信息,如果有的话,还有什么替代方案?谁能提供更多细节?

适用于 JDK 10 的视图

适用于 JDK 11 的视图

【问题讨论】:

    标签: javadoc java


    【解决方案1】:

    如果其他人有相同的查询,默认情况下不再生成帧。

    JDK-8202961 对此进行了介绍

    过去,为了允许在 API 文档中导航,标准 doclet 在窗口左侧的框架中显示索引,以允许选择类、包和(最近的)模块以显示在窗户。

    最近,doclet 现在支持“搜索”功能,它提供了一种更通用的方式来查找要查看的项目。另外,doclet 正朝着(仅)使用 HTML 5 的方向发展,HTML 5 中对框架的基本支持比 HTML 4 中的要少。

    和JDK-8187794 等等

    更新 javadoc/doclet 以默认不生成帧。如果指定“--frames”选项来生成帧,则应生成警告。未来版本中将移除对框架的支持。

    似乎如果你真的想使用框架,你可以从 JDK src 生成你自己的框架并体验警告,但这将在某个时候完全删除。

    总之,习惯了 Search 功能,框架化的 javadocs 即将被淘汰!

    【讨论】:

    • 我非常讨厌这个。
    • 嗯,它不一定是帧,但其他形式的导航树像之前的帧会很好。参考搜索功能并不是很有帮助,因为浏览导航与搜索特定术语完全不同……它并不真正喜欢 Java 目前的发展方向。
    • 我同意,此更改是不需要的。我广泛使用了框架功能,发现它是一种非常有用的 API 导航方式。如果他们想删除该功能,他们应该在 HTML 4 或 5 中找到另一种机制来提供相同的功能。
    • “搜索”的问题是你只能搜索你已经知道的东西。 Oracle 忽略了导航包的目的有时是探索和发现 API。
    • 完全同意,我经常使用框架视图来浏览特定软件包提供的内容。这是一种基本的浏览方式。这已经在各地的网络应用程序中发生了——用搜索框代替导航,这意味着你必须提前知道你在寻找什么!
    【解决方案2】:

    我创建了JANITOR – Java API Navigation Is The Only Rescue:

    将模块、包和类型(接口、类、枚举、异常、错误、注释)的导航树插入到 Java 11+ 的 Javadoc 页面中。

    【讨论】:

      【解决方案3】:

      如果您更喜欢带有 HTML iframe 的 Java 10 及更早版本的 API 文档布局,那么您可能需要查看:https://github.com/climber09/Javadoc-Frames-Generator。这是一项正在进行的工作,所以我欢迎任何反馈。

      【讨论】:

      • 虽然此链接可能会回答问题,但最好在此处包含答案的基本部分并提供链接以供参考。如果链接页面发生更改,仅链接答案可能会失效。 - From Review
      猜你喜欢
      • 1970-01-01
      • 2019-07-21
      • 1970-01-01
      • 2020-11-08
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2021-10-27
      相关资源
      最近更新 更多