【问题标题】:How do I use the old javadoc style / theme with JDK 7?如何在 JDK 7 中使用旧的 javadoc 样式/主题?
【发布时间】:2012-08-04 02:11:06
【问题描述】:

JDK 7 中用于 javadoc 的新主题对我来说很难阅读。它可能不漂亮,但我真的更喜欢旧主题。除了安装旧的 JDK 并在它们之间切换之外,我还能以某种方式使用旧的 doclet 吗?

【问题讨论】:

  • 你不是唯一一个。链接的颜色与我眼中的普通文本颜色非常接近,以至于我无法轻易地区分链接和普通文本。他们也没有强调它们。也许是我的(浅色)色盲,但我发现新主题比旧主题更不实用。
  • 在 firefox 中,在旧的 javadoc 中,您可以通过键入 / ClassName 来搜索类(注意快速查找字符 '/' 之后的前导空格)。这现在被破坏了(左下窗格不再在每个类名之后包含一个空格,这使得这成为可能)。我迫切需要这个回来!

标签: java documentation javadoc


【解决方案1】:

我知道这是一个迟到的答案,但有人开发了一个样式表,可用于获取旧的 pre-7 渲染:

http://junk-box.appspot.com/stylesheet/classic-javadoc-stylesheet/index.html

我也不喜欢较新的 post-6 样式,它的可读性较低且难以扫描。比起视觉美感,我更喜欢可读性。

【讨论】:

  • 迟到了,但仍然很感激!谢谢。
【解决方案2】:

如果它让您很困扰并且您不想乱用样式表和模板,您可以随时将 JDK 1.6 安装在另一个目录中,并改用它的 Javadoc util。

【讨论】:

  • 这是可行的,但我希望有一个简单的开关可以继续使用旧样式,如果需要的话。
  • “除了安装旧的JDK”
【解决方案3】:

我不能说我已经尝试过使用 Java 7,但 yDoc 是一个简洁的可定制 doclet。除了添加类图(也许可以过滤掉),我觉得还是可以生成原始样式的javadoc。

有一个免费版本可用(我与yWorks无关,我只是碰巧写了taglets并使用了yDoc)。

【讨论】:

  • 哎哟!以某种方式认为它更多地是关于主题而不是 doclet。
【解决方案4】:

不得不承认我还没有体验过这个,但我发现你可以为 java doc 自定义 CSS。 Here 是描述。

你可能有兴趣运行这个:

C:> javadoc -stylesheetfile C:\user\exampleStylesheet.css com.examplePackage

那里还声明它会创建“stylesheet.css”文件,因此您应该看到它的外观以及可以在那里覆盖的内容。

希望对你有帮助

【讨论】:

  • 也许我可以复制/粘贴旧的 stylesheet.css
  • 我不认为复制粘贴会起作用,两个默认的 css 看起来完全不同,7 样式更灵活,更语义化并且更符合当前标准。你绝对应该像上面解释的那样覆盖它,它比使用 java 6 容易得多
猜你喜欢
  • 2014-10-05
  • 2020-06-16
  • 2012-12-16
  • 2019-03-15
  • 2011-02-04
  • 2021-03-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多