Ruby 哪里能找到关于 ri 文档格式的说明文档

lululau · 2012年01月10日 · 最后由 huacnlee 回复于 2012年02月04日 · 5538 次阅读

问题是这样的,最近一段时间安装的所有的 gems 在查看其文档时,都会报一个错误:

/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/1.8/rdoc/ri/ri_reader.rb:54:in `initialize': No such file or directory - /Library/Ruby/Gems/1.8/doc/uuid-2.3.4/ri/UUID/cdesc-UUID.yaml (Errno::EENOENT)

好像 ri 需要一个 cdesc-CLASSNAME.yaml 一个说明文件,但是我发现最近安装的 gems 里都没有这个问题,取而代之的时 cdesc-CLASSNAME.ri 文件,而早先安装的 gems 里都有那个 yaml 文件。而如果我先把早先安装的一个 gems 卸载然后重新安装,发现那个 yaml 文件也没有了。

谁知道这是怎么回事吗?

或者哪里有关于 ri 文档格式的说明文档?

如果你不用 ri 来查 ruby 的 class,modules 和 methods,你大可不必为每个 gem 按照 ri 和 rdoc,只需要在~/.gemrc里面添加一行

gem: --no-ri --no-rdoc

好像我答非所问了,ri 和 rdoc 在 ror 社区中根本没有流行起来,很多人都默认不为 gem 自动生成 ri 的本地索引,所以如果有兼容问题也不会及时修复。

#2 楼 @lgn21st 我主要是用 Ruby 写测试程序的,所以可能更喜欢命令行一点。一般不在本地安装文档的话,那就是都直接在 rubygems.org/github 上看在线的文档吗?

#3 楼 @lululau 嗯,我看在线文档多一些,大多数的常用 gem 的文档在这里都能找到 http://rubydoc.info/

另外我的习惯是,如果我用到某一个 gem,我更喜欢去 github 上 clone 一份源码到本地,遇到问题直接查源码,这样对 gem 的原理和实现把握更大,遇到问题更容易找到核心根源问题。

#1 楼 @lgn21st 你这个对我有帮助,哈哈哈

需要 登录 后方可回复, 如果你还没有账号请 注册新账号