2009-12-11 62 views
6

我從來沒有見過安裝ri和rdoc的寶石,我的.gemrc文件有--no-ri和--no-rdoc設置。由於每一個寶石都包含ri和rdoc信息,我只是想知道我是否錯過了一些東西?安裝ri和rdoc是否有優勢?我是否因缺少安裝ri和rdoc的寶石而錯過了一些東西?

感謝

克里斯

摘要

如果不安裝裏和RDoc的,你不會失去很有價值的東西。我想也許它已經在一些IDE中使用過了(我是Emacs用戶),但似乎並非如此。

回答

11

安裝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」生成它。

+0

感謝提及寶石服務器 – 2010-09-30 19:13:00

2

如果您想要本地可用的寶石文檔,請安裝它。

+0

因此,不要真的錯過任何東西。 – 2009-12-11 12:16:58

3

就我個人而言,我正在安裝沒有rdoc和ri的寶石,因爲通常您可以在互聯網上找到您需要的所有文檔(即www.rdoc.info),因此不需要投入大量資金磁盤空間和時間的產生需要

0

本文給出了一個很大的原因,並使用RI如何:名單上

http://jstorimer.com/ri.html

最佳點是1:RI理解紅寶石。例如:

$ ri ActiveRecord::Base#save 
(from gem activerecord-3.2.8) 
Implementation from ActiveRecord::Persistence 

[...] 

(from gem activerecord-3.2.8) 
Implementation from ActiveRecord::Validations 

[...] 

通知的方法上的ActiveRecord :: Base的自身發現即使不直接。

相關問題