我从未见过为gems安装ri和rdoc的意义,我的.gemrc文件设置了--no-ri和--no-rdoc . 由于每个宝石都包含ri和rdoc信息,我只是想知道我是否遗漏了什么?为宝石安装ri和rdoc有什么好处吗?
谢谢
克里斯
Summary
如果你没有安装ri和rdoc,你就不会失去任何有 Value 的东西 . 我想也许它已经在一些IDE(我是一个Emacs用户)中使用过,但似乎并非如此 .
安装ri文档的重点只是您可以使用“ri”命令来访问方法文档 . 例如,尝试:“ri String#reverse” . 按“q”退出 .
要试用RDoc文档,请运行“gem server”,然后在浏览器中连接到localhost:8808 . 我发现它很有用 - 您甚至可以单击方法名称来查看源代码 . 当然,您可以直接进入gems文件夹并打开doc文件夹中的HTML文件 .
访问RDoc的另一种方法是gemdoc命令 . 见http://www.stephencelis.com/2008/06/12/bashfully-yours-gem-shortcuts.html . 这是非常方便的,恕我直言 .
无论如何,你可能很懒,等到你需要RDoc文档,然后用“gem rdoc”生成它 .
就个人而言,我正在安装我的宝石而没有rdoc和ri,因为通常你也可以在互联网上找到你需要的所有文档(即www.rdoc.info),所以不需要投入硬盘空间和时间这代人需要
如果您需要本地可用的gem文档,请安装它 .
本文给出了使用ri的原因和方法:
http://jstorimer.com/ri.html
该列表中的最佳点是#1:ri了解Ruby . 例如:
$ ri ActiveRecord :: Base#save(来自gem activerecord-3.2.8)从ActiveRecord :: Persistence实现
[...]
(来自gem activerecord-3.2.8)从ActiveRecord :: Validations实现
请注意,即使不直接在ActiveRecord :: Base本身上也可以找到该方法 .
4 回答
安装ri文档的重点只是您可以使用“ri”命令来访问方法文档 . 例如,尝试:“ri String#reverse” . 按“q”退出 .
要试用RDoc文档,请运行“gem server”,然后在浏览器中连接到localhost:8808 . 我发现它很有用 - 您甚至可以单击方法名称来查看源代码 . 当然,您可以直接进入gems文件夹并打开doc文件夹中的HTML文件 .
访问RDoc的另一种方法是gemdoc命令 . 见http://www.stephencelis.com/2008/06/12/bashfully-yours-gem-shortcuts.html . 这是非常方便的,恕我直言 .
无论如何,你可能很懒,等到你需要RDoc文档,然后用“gem rdoc”生成它 .
就个人而言,我正在安装我的宝石而没有rdoc和ri,因为通常你也可以在互联网上找到你需要的所有文档(即www.rdoc.info),所以不需要投入硬盘空间和时间这代人需要
如果您需要本地可用的gem文档,请安装它 .
本文给出了使用ri的原因和方法:
http://jstorimer.com/ri.html
该列表中的最佳点是#1:ri了解Ruby . 例如:
[...]
(来自gem activerecord-3.2.8)
从ActiveRecord :: Validations实现
[...]
请注意,即使不直接在ActiveRecord :: Base本身上也可以找到该方法 .