Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Already on GitHub? Sign in to your account

$ rake doc:guides not working at all #10384

DHB opened this Issue Apr 30, 2013 · 16 comments


None yet
6 participants

DHB commented Apr 30, 2013

$ rake doc:guides not working at all, neither under Windows7 nor under my Ubuntu 12.01 LTS box.


$ ruby -v && bundle -v && gem -v && rails -v
ruby 2.0.0p0 (2013-02-24) [i386-mingw32]
Bundler version 1.3.5
Rails 4.0.0.rc1

Test case:

$ rake doc:guides
rake aborted!
cannot load such file -- h:/Ruby200_p0/lib/ruby/gems/2.0.0/gems/guides/rails_guides

Tasks: TOP => doc:guides
(See full trace by running task with --trace)

@fxn fxn closed this in 5aec73d Apr 30, 2013

@fxn fxn added a commit that referenced this issue Apr 30, 2013

@fxn fxn Merge pull request #10385 from siong1987/fix_rake_doc_guides
Make `rake doc:guides` works again.  Fix #10384.

DHB commented Jun 25, 2013

Looks like it did not make it into 4.0.0 ??


steveklabnik commented Jun 26, 2013

That is correct. It was merged into master after we branched for 4.0.0. This means it should be in 4.1.0, but if @fxn backports it to 4-0-stable, will go out in 4.0.1.

Should we do that, @fxn?


fxn commented Jun 26, 2013

Please go ahead!


steveklabnik commented Jun 27, 2013

Done in 6e3cab9


fxn commented Jun 28, 2013

@steveklabnik thanks a lot, been a little off lately and appreciate help.


steveklabnik commented Jun 29, 2013


@steveklabnik steveklabnik added a commit that referenced this issue Aug 5, 2013

@siong1987 @steveklabnik siong1987 + steveklabnik Make `rake doc:guides` works again. Fix #10384.

So does this work or not? I can't decipher these posts sorry :)


dmathieu commented Sep 19, 2013

@blairrorani: the issue is closed. So it means it works.

K. Not for me it doesn't. I can get api docs but not guides. Does it work on Win7? Anybody else having this issue?


dmathieu commented Sep 19, 2013

What is your issue exactly? Have you got an error message?

Sorry man:
rake aborted!
cannot load such file -- redcloth
tasks: top=> doc:guides
(see full trace etc..)


dmathieu commented Sep 19, 2013

See the what's next section in the getting started guide

To be able to generate the Rails Guides locally with the doc:guides rake task you need to install the RedCloth gem. Add it to your Gemfile and run bundle install and you're ready to go.

Gotcha. Where is the rails forum so I can post these kinds of questions therein future? Thank you.


dmathieu commented Sep 20, 2013

There is no "forum".
You can start discussions about the development of the framework in the google group: https://groups.google.com/forum/#!forum/rubyonrails-core
And you can ask questions about your problems with the development of your application on stackoverflow: http://stackoverflow.com/questions/tagged/ruby-on-rails



I tried to generate the latest rails guides with rake doc:guides - and eventually it worked.

I had to bundle Rails 4.1.0.beta, nokogiri and redcarpet (redcloth is not used anymore). So just add these lines to your Gemfile to create the guides:

gem 'rails', :git => 'git://github.com/rails/rails.git', :branch => 'master'
gem 'redcarpet'
gem 'nokogiri'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment