为什么安装RDOCS和RI需要的时间比实际的宝石要长?

时间:2012-04-05 18:48:23

标签: ruby rubygems rdoc ri

安装宝石并等待2秒钟让宝石安装,然后等待30秒才能获得文件,这是我总是令人沮丧的,我从未使用过(谷歌,任何人?)。当本地文档通常不利于我们时,为什么我们强迫这个约定呢?

我知道您可以使用gem install rails --no-ri --no-rdoc跳过该步骤但是有没有办法在默认情况下跳过文档?

1 个答案:

答案 0 :(得分:1)

将标记添加到~/.gemrc文件中。

来自the docs

  

gem在您的主目录中查找配置文件.gemrc,   虽然您可以根据需要在命令行中指定另一个文件   (使用--config-file modifier)。只有一个配置文件   processed:命令行中最右边的一个,或默认值   $HOME/.gemrc,或者根本没有。

     

您可以在配置文件中指定三件事:   

     
      
  • 每次gem运行时使用的命令行参数
  •   
  • “RDoc”的命令行选项(在生成文档时使用)
  •   
  • GEMPATH设置
  •   
     

配置文件本身采用“YAML”格式。这是一个例子:

gem:  --local --gen-rdoc --run-tests
rdoc: --inline-source --line-numbers
gempath:
 - /usr/local/rubygems
 - /home/gavin/.rubygems
     

这样的配置文件的效果是:

     
      
  • gem仅运行“本地”操作(除非您在命令行中指定--remote--both
  •   
  • gem生成RDoc并在每次安装时运行单元测试(好主意!)
  •   
  • 当它生成RDoc时,将使用给定的参数
  •   
  • /usr/local/rubygems/home/gavin/rubygems将用作$GEM_PATH设置
  •