Offline Rails Framework Documentation

I would like to download the Rails Framework Documentation (http://
rails.rubyonrails.com/) so I can use it offline.
I tried doing 'File / Save As...' but that didn't work.

I had limited success with downloading http://corelib.rubyonrails.org/
using 'File / Save As...', but the frames get all confused.

Any help greatly appreciated.
- Paul Davidowitz

1. download wget, and run wget -m -k api.rubionrails.com (I'm not
about the switches, use --help and or google to find out)

2. you can obtain docs for a particular gem if you run rdoc in the
respective directory. Or, run rdoc with a list of paths to all the
rails gems. i.e.

rdoc c:/ruby/lib/1.8/gems/activerecord-1.x.x/lib c:/ruby/lib/... etc.

3. there was a recent thread about generating rdoc for the ruby core,
as seen on ruby-doc.org ;-). The rails docs are generated similarly.

DISCLAIMER: It's midnight here, so take this as a hint, and please
work out the details :wink:

Jano

···

On 5/29/07, Paul <pdavidow@gmail.com> wrote:

I would like to download the Rails Framework Documentation (http://
rails.rubyonrails.com/) so I can use it offline.
I tried doing 'File / Save As...' but that didn't work.

I had limited success with downloading http://corelib.rubyonrails.org/
using 'File / Save As...', but the frames get all confused.

Any help greatly appreciated.
- Paul Davidowitz

$gem_server

Then open your browser @ http://localhost:8808/

Enjoy!

···

On 5/29/07, Paul <pdavidow@gmail.com> wrote:

I would like to download the Rails Framework Documentation (http://
rails.rubyonrails.com/) so I can use it offline.
I tried doing 'File / Save As...' but that didn't work.

I had limited success with downloading http://corelib.rubyonrails.org/
using 'File / Save As...', but the frames get all confused.

Any help greatly appreciated.
- Paul Davidowitz

Jano Svitok wrote:

···

On 5/29/07, Paul <pdavidow@gmail.com> wrote:

I would like to download the Rails Framework Documentation (http://
rails.rubyonrails.com/) so I can use it offline.
I tried doing 'File / Save As...' but that didn't work.

I had limited success with downloading http://corelib.rubyonrails.org/
using 'File / Save As...', but the frames get all confused.

Any help greatly appreciated.
- Paul Davidowitz

1. download wget, and run wget -m -k api.rubionrails.com (I'm not
about the switches, use --help and or google to find out)

Please do not encourage people to do this.

It will eat up considerable bandwidth from a site that is offering a free service, and gains you nothing you cannot get for yourself in other, better ways.

--
James Britt

www.ruby-doc.org

Can you share with the list what those better ways are? Is it tar'd up
somewhere? I've always wanted to get a local copy of the api and never
thought about using wget until this mail.

···

On 5/29/07, James Britt <james.britt@gmail.com> wrote:

Jano Svitok wrote:
> On 5/29/07, Paul <pdavidow@gmail.com> wrote:
>> I would like to download the Rails Framework Documentation (http://
>> rails.rubyonrails.com/) so I can use it offline.
>> I tried doing 'File / Save As...' but that didn't work.
>>
>> I had limited success with downloading http://corelib.rubyonrails.org/
>> using 'File / Save As...', but the frames get all confused.
>>
>> Any help greatly appreciated.
>> - Paul Davidowitz
>
> 1. download wget, and run wget -m -k api.rubionrails.com (I'm not
> about the switches, use --help and or google to find out)

Please do not encourage people to do this.

It will eat up considerable bandwidth from a site that is offering a
free service, and gains you nothing you cannot get for yourself in
other, better ways.

--
James Britt

www.ruby-doc.org

Create a Rails app, and then from the root of the application execute:
rake doc:rails

That will place the API documentation in doc/api/.

--Jeremy

···

On 5/30/07, list. rb <list.rb@gmail.com> wrote:

Can you share with the list what those better ways are? Is it tar'd up
somewhere? I've always wanted to get a local copy of the api and never
thought about using wget until this mail.

On 5/29/07, James Britt <james.britt@gmail.com> wrote:
>
> Jano Svitok wrote:
> > On 5/29/07, Paul <pdavidow@gmail.com> wrote:
> >> I would like to download the Rails Framework Documentation (http://
> >> rails.rubyonrails.com/) so I can use it offline.
> >> I tried doing 'File / Save As...' but that didn't work.
> >>
> >> I had limited success with downloading http://corelib.rubyonrails.org/
> >> using 'File / Save As...', but the frames get all confused.
> >>
> >> Any help greatly appreciated.
> >> - Paul Davidowitz
> >
> > 1. download wget, and run wget -m -k api.rubionrails.com (I'm not
> > about the switches, use --help and or google to find out)
>
> Please do not encourage people to do this.
>
> It will eat up considerable bandwidth from a site that is offering a
> free service, and gains you nothing you cannot get for yourself in
> other, better ways.
>
> --
> James Britt
>
> www.ruby-doc.org
>

--
http://www.jeremymcanally.com/

My free Ruby e-book:
http://www.humblelittlerubybook.com/book/

My blogs:
http://www.mrneighborly.com/
http://www.rubyinpractice.com/

list. rb wrote:

Can you share with the list what those better ways are? Is it tar'd up
somewhere? I've always wanted to get a local copy of the api and never
thought about using wget until this mail.

Get the source (i.e gem install rails -y)
Run rdoc over the source

I'm pretty sure that's how it gets created for display on rubyonrails.com

If there's more to than that, then perhaps someone on the rails list could give more detail.

James

What am I doing wrong? Perhaps because when I installed rails I didn't pass
the -y flag?

Thanks in advance:

rake doc:rails --trace
(in /home/someonespecial/packages/aptana/workspace/cookbook)
** Invoke doc:rails (first_time)
** Invoke doc/api/index.html (first_time)
** Invoke README (first_time, not_needed)
rake aborted!
Don't know how to build task 'vendor/rails/railties/CHANGELOG'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1472:in `[]'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:369:in
`invoke_prerequisites'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `each'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `send'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `each'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:368:in
`invoke_prerequisites'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:361:in `invoke'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:355:in
`synchronize'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:355:in `invoke'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:369:in
`invoke_prerequisites'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `each'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `send'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1003:in `each'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:368:in
`invoke_prerequisites'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:361:in `invoke'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:355:in
`synchronize'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:355:in `invoke'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1739:in `top_level'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1739:in `each'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1739:in `top_level'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1761:in
`standard_exception_handling'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1733:in `top_level'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1711:in `run'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1761:in
`standard_exception_handling'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/lib/rake.rb:1708:in `run'
/usr/local/lib/ruby/gems/1.8/gems/rake-0.7.3/bin/rake:7
/usr/local/bin/rake:16:in `load'
/usr/local/bin/rake:16

···

On 5/30/07, James Britt <james.britt@gmail.com> wrote:

list. rb wrote:
> Can you share with the list what those better ways are? Is it tar'd up
> somewhere? I've always wanted to get a local copy of the api and never
> thought about using wget until this mail.
>

Get the source (i.e gem install rails -y)
Run rdoc over the source

I'm pretty sure that's how it gets created for display on rubyonrails.com

If there's more to than that, then perhaps someone on the rails list
could give more detail.

James

List Rb wrote:

What am I doing wrong? Perhaps because when I installed rails I didn't
pass
the -y flag?

Thanks in advance:

That's exactly what I get. On the other hand, doesn't using the
installed gems for docs mean that they will be split up into rails,
activerecord etc...?

best,
Dan

···

--
Posted via http://www.ruby-forum.com/.

I guess it's wget for the win?

···

On 5/31/07, Daniel Lucraft <dan@fluentradical.com> wrote:

List Rb wrote:
> What am I doing wrong? Perhaps because when I installed rails I didn't
> pass
> the -y flag?
>
> Thanks in advance:

That's exactly what I get. On the other hand, doesn't using the
installed gems for docs mean that they will be split up into rails,
activerecord etc...?

best,
Dan

--
Posted via http://www.ruby-forum.com/.

Ok, so some more things to try:

1. [1] says do
  rake rails:freeze:gems
before
  rake doc:rails

2. if you don't want to freeze your rails app, create a new one and freeze that.

3. this is a Rails specific question now, so it'd better to ask on
rails list/group - this is not a question of rdoc anymore, it's about
how their rakefiles are set up.

[1] http://squizlog.keithpitty.org/archives/000501.html

(I didn't try this, I just googled, so I might be wrong.)

Jano

···

On 6/2/07, list. rb <list.rb@gmail.com> wrote:

I guess it's wget for the win?

On 5/31/07, Daniel Lucraft <dan@fluentradical.com> wrote:
>
> List Rb wrote:
> > What am I doing wrong? Perhaps because when I installed rails I didn't
> > pass
> > the -y flag?
> >
> > Thanks in advance:
>
> That's exactly what I get. On the other hand, doesn't using the
> installed gems for docs mean that they will be split up into rails,
> activerecord etc...?
>
> best,
> Dan