Cài đặt đá quý có thể bị chậm. Một trong những thủ phạm lớn nhất là tài liệu. Mỗi khi bạn cài đặt một viên ngọc, máy tính của bạn phải quét nguồn của viên đá quý đó và tạo tài liệu.
Điều này có thể hữu ích nếu bạn thường xuyên cần kiểm tra tài liệu về đá quý khi bạn ngoại tuyến. Chỉ cần chạy gem server và trỏ trình duyệt của bạn tại https:// localhost:8808 để truy cập chúng. Lệnh ri cũng hữu ích để tìm kiếm tài liệu từ thiết bị đầu cuối.
Nhưng nếu bạn giống tôi, bạn có thể không sử dụng tài liệu địa phương. Bạn có thể có một kết nối Internet tốt ở hầu hết các thời điểm. Vì vậy, thời gian dành cho việc tạo tài liệu chỉ là lãng phí thời gian.
Nếu bạn đang sử dụng Bundler để cài đặt tất cả các đá quý của mình, bạn không phải làm bất cứ điều gì. Bundler bỏ qua rdoc / ri theo mặc định. Nếu bạn đang sử dụng trực tiếp lệnh gem, bạn sẽ cần thực hiện một chút cấu hình.
Bạn có thể đã biết rằng bạn có thể tắt tạo rdoc / ri khi bạn chạy cài đặt đá quý, bằng cách chuyển vào một số cờ nhất định.
gem install honeybadger --no-rdoc --no-ri # The old, deprecated way
gem install honeybadger --no-document # The new way
Bạn cũng có thể yêu cầu rubygem áp dụng các cờ này làm mặc định. Chỉ cần thêm dòng sau vào tệp ~ / .gemrc của bạn:
gem: --no-document
Nhưng nếu bạn đang lên kế hoạch cho một chuyến đi cắm trại và cần lấy tài liệu địa phương thì sao? Không có vấn đề gì khi bạn tự tạo.
gem rdoc --all --overwrite # regen all docs
gem rdoc honeybadger # generate docs for one gem
Tuy nhiên, hãy cẩn thận nếu bạn chọn đăng ký lại tất cả tài liệu của mình. Nó có thể mất một thời gian. :)