Tips&Tricks: Установка gem’ов без генерации документации
сентября 5, 2012 | Published in Ruby Gems, Tips&Tricks | 5 Comments
Зачем?
Все мы знаем, что при установке gem’ов часто генерация документации занимает куда больше времени, чем сама установка gem’а, при этом никто не пользуется оффлайновой документацией. Зачем открывать новую вкладку и запускать gem server, если вся документация доступна онлайн? Если вы не пользуетесь оффлайн документацией, то зачем засорять ею жесткий диск и тратить время на ожидание ее генерации при установке gem’ов?
Для отключения генерации документации с командой gem install используют флаги —no-rdoc и —no-ri, например, так:
$ gem install rails —no-rdoc —no-ri
Однако есть вариант получше — использовать файл .gemrc в вашей home/ директории.
Просто добавьте в него следующую строку:
gem: —no-rdoc —no-ri
И вы забудете о генерации документации навсегда!
сентября 5, 2012 at 11:28 (#)
Мне тебя жаль, Владимир, если ты до сих пор об этих опциях не знал
сентября 5, 2012 at 12:34 (#)
Я перед установкой Rails создаю файл ~/.gemrc
со следующем содержимым:
# ~/.gemrc
—
:verbose: true
:bulk_threshold: 1000
install: —no-ri —no-rdoc —env-shebang
:sources:
- http://gemcutter.org
- http://gems.rubyforge.org/
- http://gems.github.com
:benchmark: false
:backtrace: false
update: —no-ri —no-rdoc —env-shebang
:update_sources: true
сентября 5, 2012 at 15:15 (#)
Парсер — лох
сентября 5, 2012 at 15:50 (#)
Рекомендую вспомнить о том, что этой скачанной документацией можно будет пользоваться через команду ri. Например, ri link_to. Вывод по этой команде будет абсолютно идентичен официальной документации на сайте рельсов, а открывать браузер и лезть в интернет не придется. По-моему очевидный плюс, учитывая то, что в доки иногда приходится заглядывать. Тем более что вкупе с командой gem server и наличием нормальной документации к гемам все становится еще удобнее.
сентября 5, 2012 at 20:51 (#)
Мне больше нравится комментарии к коду на гитхабе читать. Тут уже дело вкуса т.с., а совет для тех, кто разделяет мои вкусы.