Ruby on Rails的离线帮助
Wednesday, 8. November 2006, 02:07:39
Rails 1.1.6的文档因为采用了不同的格式,所以用rdoc -Y来生成rdoc的离线帮助会被忽略掉。只能自己手工转换。基于我自己做的OSX IntelMac的发行包,操作如下。
先随便找个地方,建立一个临时项目并进入目录位置
$ rails dummy
$ cd dummy
锁定项目的gems
$ rake freeze_gems
建立一个缺少的空文件
$ echo > vendor/rails/activesupport/README
转换帮助文档
$ rake doc:rails
经过这一串操作之后,在dummy/doc/api目录里面的就是生成的离线帮助。
把这个api的目录改名为rdoc,然后复制到/opt/rails/lib/ruby/gems/1.8/doc/rails-1.1.6目录里面。
这样,就可以通过运行
$ gem_server
来启动离线帮助网页服务,打开浏览器浏览 http://localhost:8808 来查看rails帮助了。
先随便找个地方,建立一个临时项目并进入目录位置
$ rails dummy
$ cd dummy
锁定项目的gems
$ rake freeze_gems
建立一个缺少的空文件
$ echo > vendor/rails/activesupport/README
转换帮助文档
$ rake doc:rails
经过这一串操作之后,在dummy/doc/api目录里面的就是生成的离线帮助。
把这个api的目录改名为rdoc,然后复制到/opt/rails/lib/ruby/gems/1.8/doc/rails-1.1.6目录里面。
这样,就可以通过运行
$ gem_server
来启动离线帮助网页服务,打开浏览器浏览 http://localhost:8808 来查看rails帮助了。


