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

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

问题是这样的,最近一段时间安装的所有的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文档格式的说明文档?

共收到 6 条回复

如果你不用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 你这个对我有帮助,哈哈哈

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