我正在使用 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 认为好看的东西吗?
最佳答案
如果您查看 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 中的
。听起来这对 Darkfish 是一个有用的补充,作者甚至可能很高兴有人希望他的软件变得更好。self.render_template
的新变量/darkfish.rb
关于css - 如何自定义 rdoc Darkfish 样式表?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/5574936/