레일 애플리케이션 문서를 생성하기위한 RDoc 템플릿 변경

Question

레일즈 3.2.13 앱에 몇 가지 문서를 추가했습니다.

# 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을 실행 : 나는 레이크 작업을 사용하여 잘 문서 (실행 RDoc 3.12.2)를 생성 할 수 있습니다. 하지만 저는 Hanna 템플릿의 기본 모양이 마음에 들지 않습니다. Hanna에서 사용되는 기본 CSS 파일을 무시하는 CSS 파일을 제공하여 CSS를 편집 할 수 있습니까?

감사합니다.

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

지금 (프로젝트 디렉토리로 변경 /tmp 또는 같은) 원하는 위치로 거기에서 기본 템플릿을 복사 : 모든

Answer 1

먼저 템플릿이 어디에 있는지 찾을

⮀ 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 

그게 전부 야. 희망이 도움이됩니다.