2

我刚刚向我的 Rails 3.2.13 应用程序添加了一些文档。我可以通过使用 rake 任务很好地生成文档（运行 RDoc 3.12.2）：

# lib/tasks/documentation.rake
Rake::Task["doc:app"].clear
Rake::Task["doc/app"].clear
Rake::Task["doc/app/index.html"].clear

namespace :doc do
    RDoc::Task.new('app') do |rdoc|
        rdoc.rdoc_dir  = 'doc/app'
        rdoc.generator = 'hanna'
        rdoc.title     = 'Stoffi Web App Documentation'
        rdoc.main      = 'doc/Overview'
        rdoc.options << '--charset' << 'utf-8'
        rdoc.rdoc_files.include('app/**/*.rb')
        rdoc.rdoc_files.include('doc/*')
    end
end

...然后运行rake doc:app​​. 但我真的不喜欢 Hanna 模板的默认外观。有没有办法编辑 CSS，也许是通过提供我自己的 CSS 文件来覆盖 Hanna 中使用的默认文件？

谢谢！

4

1 回答 1

3

首先找到您的模板所在的位置：

⮀ RDPATH=$(dirname $(gem which rdoc))
# ⇒ /home/am/.rvm/rubies/ruby-head/lib/ruby/2.1.0

现在将默认模板从那里复制到所需位置（更改/tmp为您的项目目录或类似目录）：

⮀ cp -r $RDPATH/rdoc/generator/template/darkfish /tmp/myniftytemplate

最后，让我们教一下rdoc：

class RDoc::Options
  def template_dir_for template
    "/tmp/#{template}"
  end
end

RDoc::Task.new('app') do |rdoc|
  rdoc.template = 'myniftytemplate'
  …
end

而已。希望能帮助到你。

于 2013-04-02T12:31:15.350 回答