如何使 README_FOR_APP 的内容出现在 doc/app/index.html 中

我想要的内容doc/README_FOR_APP出现在doc/app/index.html， 当我做rake doc:app.

目前，内容为：

这是 Rails 应用程序文档的 API 文档。

To see README_FOR_APP，我必须点击README_FOR_APP在左侧的页面列表中。

我看过如何重命名或移动 Rails 的 README_FOR_APP https://stackoverflow.com/questions/2068639/how-to-rename-or-move-railss-readme-for-app但OP声称他already看到我想要的行为。

我正在使用 Rails 3.1.3。

首先，创建一个新的 rake 文件（例如lib/tasks/documentation.rake）在您的项目中。然后重新定义rake任务：

Rake::Task["doc:app"].clear
Rake::Task["doc/app"].clear
Rake::Task["doc/app/index.html"].clear

namespace :doc do
    Rake::RDocTask.new('app') do |rdoc|
        rdoc.rdoc_dir = 'doc/app'
        rdoc.title    = 'YOUR_TITLE'
        rdoc.main     = 'doc/README_FOR_APP' # define README_FOR_APP as index

        rdoc.options << '--charset' << 'utf-8'

        rdoc.rdoc_files.include('app/**/*.rb')
        rdoc.rdoc_files.include('lib/**/*.rb')
        rdoc.rdoc_files.include('doc/README_FOR_APP')

    end
end