我不使用安装在我的机器或我处理的服务器中的 gem 的 RI 或 RDoc 输出(我使用其他文档方式)。
我安装的每个 gem 默认安装 RI 和 RDoc 文档,因为我忘记设置 --no-ri --no-rdoc
。
有没有办法让这两个标志成为默认值?
gem server
时,我记得我的 $HOME/.gemrc
中有这些代码,这真的让我很丧......谷歌并不总是在那里。
show-source
作为生成文档的替代方法。它将显示内联注释,这些注释通常与 ri/rdoc 的内容相同。
您只需将以下行添加到本地 ~/.gemrc
文件(它位于您的 home 文件夹中):
gem: --no-document
经过
echo 'gem: --no-document' >> ~/.gemrc
或者您可以将此行添加到全局 gemrc
配置文件中。
以下是如何找到它(在 Linux 中):
strace gem source 2>&1 | grep gemrc
the RubyGems CLI Reference 中记录了 --no-document
选项。
只需将此行添加到您的 ~/.gemrc 或 /etc/gemrc:
gem: --no-document
注意:原来的答案是:
install: --no-rdoc --no-ri
update: --no-rdoc --no-ri
这不再有效; RVM 文档已经更新,因此当前只包含 gem
指令的答案是正确的。
install: --no-rdoc --no-ri\nupdate: --no-rdoc --no-ri
@mpapis,您为什么更改了 RVM 文档并更改了此答案?
gem:
而不是两个单独的条目。
ruby -e "require 'etc';puts Etc.sysconfdir"
确定 gemrc
配置文件的路径。
请注意,根据新的 guides,已弃用 --no-ri
和 --no-rdoc
。推荐的方法是在 ~/.gemrc
或 /etc/gemrc
中使用 --no-document
。
install: --no-document
update: --no-document
或者
gem: --no-document
在 Linux(可能还有 Mac)上:
echo 'gem: --no-document' >> ~/.gemrc
这个单线曾经在这里的评论中,但不知何故消失了。
~/.gemrc
,您应该使用 >>
。
echo 'gem: --no-doc --no-ri' >> ~/.gemrc
和你写的有区别吗?还是两者有相同的效果?
--no-doc --no-ri
已弃用(有关选项,请参阅 guides.rubygems.org/command-reference/#gem_install)
# /home/{user}/.gemrc
---
: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
在 Windows XP 上,.gemrc 文件的路径是
c:\Documents and Settings\All Users\Application Data\gemrc
而且这个文件是默认不创建的,你应该自己创建。
适用于 Windows 7 用户的 oneliner:
(echo install: --no-document && echo update: --no-document) >> c:\ProgramData\gemrc
如上所述,将 gem: --no-document
放入您的 gem 文件中。但是,系统范围的 gemrc 不一定会进入 /etc/gemrc
。如果您使用的是 RVM,或者您在 /usr/local/bin
下安装了 Ruby,则它需要放在不同的位置。您可以通过运行 irb
并键入...来找到此位置
require 'rubygems'
Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE
请参阅 here 上关于此的原始帖子。
ruby -rrubygems -e'puts Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE'
一步一步:
从终端创建/编辑 .gemrc 文件:
vi ~/.gemrc
您将打开一个名为 vi 的编辑器。粘贴:
gem: --no-ri --no-rdoc
单击“esc”按钮。
输入:
:exit
您可以使用以下命令检查一切是否正确:
sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit ~/.gemrc
~/.gemrc
文件。
sudo
来编辑您自己用户的 ~/.gemrc
。
在 Windows7 上 .gemrc 文件不存在,您可以让 Ruby 像这样创建一个(在资源管理器中这样做并不容易)。
gem sources --add http://rubygems.org
您必须确认(这是不安全的)。现在该文件已在您的 userprofile 文件夹 (c:\users\) 中创建
您可以编辑文本文件以删除您添加的源,也可以使用
gem sources --remove http://rubygems.org
对于 Windows 用户,Ruby 不设置 .gemrc 文件。因此,您必须在主目录 (echo %USERPROFILE%
) 中创建 .gemrc 文件并在其中放入以下行:
gem: --no-document
正如前面的答案中已经提到的,不要使用 --no-ri 和 --no-rdoc 导致它被弃用。自己看:
gem help install
/etc/gemrc
也不适用于我。