如何瀏覽本地項目文檔

Question

是否有任何Rails方式瀏覽在本地doc/文件夾中生成的文檔，其命令rake doc:app？

我知道我可以配置Apache來提供doc文件夾中的文件，但是如果Rails沒有提供這種方法，我會感到驚訝。

Answer 1

Rails沒有提供服務的原因是因爲它只是靜態HTML - 您可以直接在瀏覽器中打開它（例如，firefox doc/app/index.html），而不需要服務器。

如果你願意，你可以在lib/tasks/browserdoc.rake添加自己的Rake任務此：

namespace :doc do 
    desc "Browse application documentation" 
    task :open do 
     `firefox doc/app/index.html` 
    end 
end 

一些系統瀏覽器無關的快捷鍵可以使用，而不是硬編碼的瀏覽器名稱;在Mac OSX上的open將在您當前的瀏覽器中打開一個HTML文件，在大多數現代Linux系統上也將打開一個HTML文件sensible-browser。