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

И вы забудете о генерации документации навсегда!

Tags: , , ,

Responses

  1. da says:

    сентября 5, 2012 at 11:28 (#)

    Мне тебя жаль, Владимир, если ты до сих пор об этих опциях не знал

  2. itsNikolay says:

    сентября 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

  3. dmitriy budnik says:

    сентября 5, 2012 at 15:15 (#)

    Парсер — лох

  4. Alex Klyanchin says:

    сентября 5, 2012 at 15:50 (#)

    Рекомендую вспомнить о том, что этой скачанной документацией можно будет пользоваться через команду ri. Например, ri link_to. Вывод по этой команде будет абсолютно идентичен официальной документации на сайте рельсов, а открывать браузер и лезть в интернет не придется. По-моему очевидный плюс, учитывая то, что в доки иногда приходится заглядывать. Тем более что вкупе с командой gem server и наличием нормальной документации к гемам все становится еще удобнее.

  5. admin says:

    сентября 5, 2012 at 20:51 (#)

    Мне больше нравится комментарии к коду на гитхабе читать. Тут уже дело вкуса т.с., а совет для тех, кто разделяет мои вкусы.

Leave a Response

Для подсветки кода используйте BB - коды: [language]...[/language], где language может быть: ruby, javascript, css, html.