How do I generate RDOC for (all of) Rails?

半世苍凉 提交于 2019-11-28 17:06:42
sudo gem rdoc --all --overwrite

The easiest I found was to just download them from railsapi.com and unpack the file into /Library/Ruby/Gems/1.8/doc/rails-2.3.3/rdoc/

If you installed rails with the rdoc (sudo gem install rails) You can access it via

gem server

Below is my attempt to clarify the steps a bit on how to get the rails 3.1 docs downloaded locally to your machine as the equivalent of http://api.rubyonrails.org/

  1. Go to the sdoc project at https://github.com/voloko/sdoc and get the project (or just do gem install sdoc)
  2. Visit the rails project at https://github.com/rails/rails and git clone it to your local machine
  3. Go into the rails clone and run sdoc -N rails
  4. This will take a while. When it is done you will have a new directory called doc
  5. You can move the doc directory anywhere you like and open the index.html file in a browser. Note that you do not need a web server for this to work.

As a side note it looks like sdoc has officially become the docs for the Ruby on Rails API (see http://weblog.rubyonrails.org/2011/8/29/the-rails-api-switches-to-sdoc)

You can freeze Rails in an app and run rake doc:rails to get the docs.

rails doc_project
cd doc_project
rake rails:freeze
rake doc:rails

The RDocs should be located in doc/api directory. You can use rake rails:freeze:edge to get documentation for Edge Rails.

Alternatively you can download the docs from a site like Rails Brain to get a searchable template with it as well.

If you are wanting the docs to show up in gem server then the easiest thing may be to re-install the rails gem with the rdoc option.

sudo gem install rails --rdoc
amjad

Run the command bundle exec rdoc on command line.

It will generate all documentation of your code.

From the Rails project Rakefile

desc "Generate documentation for the Rails framework"
Rake::RDocTask.new do |rdoc|
  rdoc.rdoc_dir = 'doc/rdoc'
  rdoc.title = "Ruby on Rails Documentation"

  rdoc.options << '--line-numbers' << '--inline-source'
  rdoc.options << '-A cattr_accessor=object'
  rdoc.options << '--charset' << 'utf-8'

  rdoc.template = ENV['template'] ? "#{ENV['template']}.rb" : './doc/template/horo'

  rdoc.rdoc_files.include('railties/CHANGELOG')
  rdoc.rdoc_files.include('railties/MIT-LICENSE')
  rdoc.rdoc_files.include('railties/README')
  rdoc.rdoc_files.include('railties/lib/{*.rb,commands/*.rb,rails/*.rb,rails_generator/*.rb}')

  rdoc.rdoc_files.include('activerecord/README')
  rdoc.rdoc_files.include('activerecord/CHANGELOG')
  rdoc.rdoc_files.include('activerecord/lib/active_record/**/*.rb')
  rdoc.rdoc_files.exclude('activerecord/lib/active_record/vendor/*')

  rdoc.rdoc_files.include('activeresource/README')
  rdoc.rdoc_files.include('activeresource/CHANGELOG')
  rdoc.rdoc_files.include('activeresource/lib/active_resource.rb')
  rdoc.rdoc_files.include('activeresource/lib/active_resource/*')

  rdoc.rdoc_files.include('actionpack/README')
  rdoc.rdoc_files.include('actionpack/CHANGELOG')
  rdoc.rdoc_files.include('actionpack/lib/action_controller/**/*.rb')
  rdoc.rdoc_files.include('actionpack/lib/action_view/**/*.rb')
  rdoc.rdoc_files.exclude('actionpack/lib/action_controller/vendor/*')

  rdoc.rdoc_files.include('actionmailer/README')
  rdoc.rdoc_files.include('actionmailer/CHANGELOG')
  rdoc.rdoc_files.include('actionmailer/lib/action_mailer/base.rb')
  rdoc.rdoc_files.exclude('actionmailer/lib/action_mailer/vendor/*')

  rdoc.rdoc_files.include('activesupport/README')
  rdoc.rdoc_files.include('activesupport/CHANGELOG')
  rdoc.rdoc_files.include('activesupport/lib/active_support/**/*.rb')
  rdoc.rdoc_files.exclude('activesupport/lib/active_support/vendor/*')
end

# Enhance rdoc task to copy referenced images also
task :rdoc do
  FileUtils.mkdir_p "doc/rdoc/files/examples/"
  FileUtils.copy "activerecord/examples/associations.png", "doc/rdoc/files/examples/associations.png"
end

If you need to generate edge docs, you can perform something like this

git clone git://github.com/rails/rails.git ~/rails
# or if you have repo, just checkout interested branch
cd ~
ruby ~/rails/railties/bin/rails docapp
cd docapp
ln -s ~/rails vendor/rails
rake doc:rerails
rake doc:guides
$ rake rails:freeze:gems
$ rake doc:rails
$ rake rails:unfreeze
$ sudo mv doc/api/* /Library/Ruby/Gems/1.8/doc/rails-2.3.5/rdoc
$ gem server
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!