关于ruby:如何制作–no-ri –no-rdoc是gem install的默认设置?

How to make --no-ri --no-rdoc the default for gem install?

我不使用安装在我的机器或我处理的服务器中的gems的ri或rdoc输出(我使用其他文档方法)。

我安装的每个gem默认情况下都会安装ri和rdoc文档,因为我忘记设置--no-ri --no-rdoc

有没有办法让这两个标志成为默认标志?


您只需在本地~/.gemrc文件中添加以下行(它在您的主文件夹中)

1
gem: --no-document

或者可以将此行添加到全局gemrc配置文件中。以下是如何找到它(在Linux中)

1
strace gem source 2>&1 | grep gemrc


根据RVM文件:

Just add this line to your ~/.gemrc or /etc/gemrc:

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

注:原始答案为:

1
2
install: --no-rdoc --no-ri
update: --no-rdoc --no-ri

这不再有效;RVM文档已经更新,因此当前仅包含gem指令的答案是正确的。


注意,根据新指南,--no-ri--no-rdoc已被弃用。建议在~/.gemrc/etc/gemrc中使用--no-document

1
2
install: --no-document
update: --no-document

1
gem: --no-document

在Linux(可能还有Mac)上:

1
echo 'gem: --no-document' >> ~/.gemrc

这一行曾经出现在这里的评论中,但不知何故消失了。


#/主页/用户/.gemrc

1
2
3
4
5
6
7
8
9
10
---
:update_sources: true
:sources:
- http://gems.rubyforge.org/
- http://gems.github.com
:benchmark: false
:bulk_threshold: 1000
:backtrace: false
:verbose: true
gem: --no-ri --no-rdoc

http://webonrails.com/2008/12/03/skiping-installation-of-ri-and-rdoc-documentation-while-installation-gems/


在Windows XP上,.gemrc文件的路径是

1
c:\Documents and Settings\All Users\Application Data\gemrc

这个文件不是默认创建的,您应该自己创建。


适用于Windows 7用户的OneLiner:

(echo install: --no-document && echo update: --no-document) >> c:\ProgramData\gemrc


可以使用.gemrc配置文件指定默认选项。

关于gem配置文件的文档


如上所述,将gem: --no-document放入gem文件中。然而,系统范围的GEMRC并不一定总是进入/etc/gemrc。如果您使用的是RVM,或者您在/usr/local/bin下安装了Ruby,那么它需要位于不同的位置。您可以通过运行irb并键入…

1
2
require 'rubygems'
Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE

请看这里的原始帖子。


一步一步:

要从终端创建/编辑.gemrc文件,请执行以下操作:

1
vi  ~/.gemrc

您将打开一个名为vi的编辑器。粘贴:

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

单击"Esc"按钮。

输入类型:

1
:exit

您可以使用以下命令检查一切是否正确:

1
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit ~/.gemrc


在Windows7中,不存在.gemrc文件,您可以让Ruby创建这样的文件(在Explorer中这样做不容易)。

1
gem sources --add http://rubygems.org

你必须确认(它不安全)。现在,该文件在用户配置文件文件夹(C:users)中创建。

可以编辑文本文件以删除添加的源,也可以使用

1
gem sources --remove http://rubygems.org


对于Windows用户,Ruby没有设置.gemrc文件。因此,您必须在主目录(echo %USERPROFILE%中)中创建.gemrc文件,并在其中放入以下行:

1
gem: --no-document

正如前面的答案中已经提到的,不要使用——没有ri和——没有rdoc,这会导致它被否决。自己看看:

1
gem help install