css - 如何自定义 rdoc Darkfish 样式表？

Question

我正在使用 Rake 为我的元素生成 RDoc 文档，但我真的很讨厌 Darkfish 似乎生成的灰色样式。我对其他一切都很满意，我只是想让配色方案更具可读性。

这是我的抽佣任务:

Rake::RDocTask.new do |rd|
    rd.main = "README.rdoc"
    rd.title = "My Title"
    rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
    rd.options = ['--main', 'README.rdoc']
end

我尝试将 '--style', 'doc/rdoc.css' 添加到上面的 rd.options 中，但它提示 - -style 是未知选项并忽略它。我似乎找不到关于如何自定义模板或 css 等的任何文档；我只需要忍受 Darkfish 认为好看的东西吗？

Answer 1

如果您查看 Darkfish 模板，您将看到的唯一 CSS 引用是这样的:

<link type="text/css" media="screen" href="<%= rel_prefix %>/rdoc.css" rel="stylesheet" />

其中一些有 rel_prefix 而有些则没有。任何模板中都没有包含其他样式表的内容。据推测，您应该只将您的颜色更改应用到 rdoc.css 或手动编辑模板以将另一个样式表包含在您的修改中。

更好的方法是将 --style 支持打入 Darkfish 并向作者发送补丁。看起来你只需要在模板中添加一点额外的 erb，一些开关解析逻辑，以及一个围绕调用 lib/rdoc/generator 中的 self.render_template 的新变量/darkfish.rb。听起来这对 Darkfish 是一个有用的补充，作者甚至可能很高兴有人希望他的软件变得更好。