Suave’s Blog

看 gem 文档除了 gem_server 发现了一个 bdoc, 还不错.

安装简单:

git clone github.com/manalang/bdoc.git
gem build bdoc.gemspec
gem install bdoc-0.2.0.gem

完成

使用只要在 term 里执行 bdoc 即可

$rails dummy_app
$cd dummy_app
$rake rails:freeze:gems
$echo >vendor/rails/activesupport/README
$rake doc:rails

在 doc/api 目录下面会生成HTML版本的Rails Doc, 拷贝出来以后删掉dummy_app即可.

上面操作中第三步的作用的锁定当前 Rails 版本, 并将其复制到 vendor 目录下, 之后系统安装那个版本的 Rails 对于这个 app 来说都是无用的, 这样可以有效的避免由于 Rails 升级带来的兼容性问题.
通过 script/about 可以查看 app 当前 Rails 的版本.

关于Rails Freeze & Unfreeze更多的内容可以参考这篇文章: Should I freeze my Rails application?