如何自定義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樣式表？

回答

相關問題