如何自定义rdoc Darkfish样式表？

我用耙子生成RDoc文档我的项目，但我真的很讨厌灰色的灰色风格，Darkfish似乎产生。我对其他一切都很满意，我只是想让配色方案更具可读性。如何自定义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认为看起来不错的东西？

来源

2011-04-07 decitrig

Darkfish与--template 'your_template_name' 模板支撑;这将需要建立一个rdoc插件宝石，我相信。

这可能会有所帮助：http://fossplanet.com/f14/making-rdoc-template-gem-26986/

的RDoc的插件宝石意思是宝石与目录结构，如：

./lib/rdoc/generator/template/#{your template name and files copied from rdoc-2.blah/lib/rdoc/generator/template/darkfish}

和

./rdoc/generate.rb前面加上上面的模板目录到$ LOAD_PATH。（$LOAD_PATH.unshift(File.expand_path(File.join(Dir.pwd,'..','lib', "#{..... and so on}"）

来源

2011-04-08 14:56:21

如果你看一下Darkfish模板，唯一的CSS引用，你会看到的是这样的事情：

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

他们中有些人有rel_prefix和一些不。没有任何模板可以包含其他样式表。据推测，您只需将着色更改应用到rdoc.css或手动编辑模板以包含您的修改的其他样式表。

一个更好的方法是修补--style支持到Darkfish发送笔者补丁。看起来你只是需要额外再培训局的一个小位添加到模板，有些交换机解析逻辑，以及一个新的变量在lib/rdoc/generator/darkfish.rb各地调用self.render_template。听起来这将是对Darkfish有益的补充，作者甚至可以为有人想让他的软件变得更好而感到高兴。

来源

2011-04-07 02:05:12

难道你不能抓住darkfish生成的.css文件的副本，然后进行修改，并将其存储在硬盘上的单独目录中。那么在你的rake任务中，当rdoc完成时只是覆盖.css文件？

来源

2012-03-02 02:05:35 user1182000

如何自定义rdoc Darkfish样式表？

回答

相关问题