Je n'utilise pas la sortie RI ou RDoc des gems que j'installe sur ma machine ou sur les serveurs que je gère (j'utilise d'autres moyens de documentation).
Chaque gem que j'installe installe la documentation RI et RDoc par défaut, car j'ai oublié de définir --no-ri --no-rdoc
.
Est-il possible de faire de ces deux drapeaux la valeur par défaut?
Vous ajoutez juste la ligne suivante à votre fichier ~/.gemrc
local (il se trouve dans votre dossier home)
gem: --no-document
ou vous pouvez ajouter cette ligne au fichier de configuration global de gemrc. Voici comment le trouver (sous Linux)
strace gem source 2>&1 | grep gemrc
De documentation de RVM :
Ajoutez simplement cette ligne à votre
~/.gemrc
ou/etc/gemrc
:
gem: --no-rdoc --no-ri
Remarque: La réponse initiale était:
install: --no-rdoc --no-ri
update: --no-rdoc --no-ri
Ce n'est plus valide; les documents RVM ont été mis à jour depuis lors, la réponse actuelle à inclure uniquement la directive gem
est la bonne.
Notez que --no-ri
et --no-rdoc
ont été déconseillés en fonction de la nouvelle guides . La méthode recommandée consiste à utiliser --no-document
dans ~/.gemrc
ou /etc/gemrc
.
install: --no-document
update: --no-document
ou
gem: --no-document
Sous Linux (et probablement Mac):
echo 'gem: --no-document' >> ~/.gemrc
Ce one-liner était dans les commentaires ici, mais a en quelque sorte disparu.
# /home/{userBuch/.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
Sous Windows XP, le chemin du fichier .gemrc est
c:\Documents and Settings\All Users\Application Data\gemrc
et ce fichier n’est pas créé par défaut, vous devez le créer vous-même.
Une ligne pour les utilisateurs de Windows 7:
(echo install: --no-document && echo update: --no-document) >> c:\ProgramData\gemrc
Vous pouvez spécifier les options par défaut à l'aide du fichier de configuration .gemrc
.
Comme mentionné ci-dessus, mettez gem: --no-document
dans votre fichier gem. Cependant, le gemrc à l’échelle du système n’ira pas toujours nécessairement dans /etc/gemrc
. Si vous utilisez RVM ou si vous avez Ruby installé sous /usr/local/bin
, il doit être placé à un autre emplacement. Vous pouvez trouver cet emplacement en exécutant irb
et en tapant ...
require 'rubygems'
Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE
Voir le post original à ce sujet ici .
Pas à pas:
Pour créer/éditer le fichier .gemrc à partir du terminal:
vi ~/.gemrc
Vous allez ouvrir un éditeur appelé vi. coller dans:
gem: --no-ri --no-rdoc
cliquez sur le bouton 'esc'.
tapez:
:exit
Vous pouvez vérifier si tout est correct avec cette commande:
Sudo /Applications/TextEdit.app/Contents/MacOS/TextEdit ~/.gemrc
Sous Windows 7, le fichier .gemrc n’est pas présent, vous pouvez laisser Ruby en créer un comme ceci (ce n’est pas facile à faire dans l’Explorateur).
gem sources --add http://rubygems.org
Vous devrez confirmer (c'est dangereux). Maintenant, le fichier est créé dans votre dossier userprofile (c:\users \)
Vous pouvez éditer le fichier texte pour supprimer la source que vous avez ajoutée ou le supprimer avec
gem sources --remove http://rubygems.org
Pour les utilisateurs de Windows, Ruby ne configure pas le fichier .gemrc. Vous devez donc créer un fichier .gemrc dans votre répertoire personnel (echo %USERPROFILE%
) et y insérer la ligne suivante:
gem: --no-document
Comme déjà mentionné dans les réponses précédentes, n'utilisez pas --no-ri et --no-rdoc, car il est obsolète. Voyez vous-même:
gem help install