การติดตั้งอัญมณีสามารถทำได้ช้า หนึ่งในผู้ร้ายที่ใหญ่ที่สุดคือเอกสาร ทุกครั้งที่คุณติดตั้งอัญมณี คอมพิวเตอร์ของคุณจะต้องสแกนแหล่งที่มาของอัญมณีนั้นและสร้างเอกสารประกอบ
สิ่งนี้มีประโยชน์หากคุณต้องตรวจสอบเอกสารเกี่ยวกับอัญมณีบ่อยครั้งเมื่อคุณออฟไลน์ เพียงเรียกใช้ gem server และชี้เบราว์เซอร์ของคุณไปที่ https://localhost:8808 เพื่อเข้าถึง คำสั่ง ri ยังสะดวกสำหรับการค้นหาเอกสารจากเทอร์มินัล
แต่ถ้าคุณเป็นเหมือนฉัน คุณคงไม่ได้ใช้เอกสารในเครื่อง คุณอาจมีการเชื่อมต่ออินเทอร์เน็ตที่ดีในบางครั้ง ดังนั้นเวลาที่ใช้ในการสร้างเอกสารจึงเป็นการเสียเวลาเปล่า
หากคุณใช้ Bundler เพื่อติดตั้งอัญมณีทั้งหมดของคุณ คุณไม่จำเป็นต้องดำเนินการใดๆ Bundler ข้าม rdoc/ri โดยค่าเริ่มต้น หากคุณกำลังใช้คำสั่ง gem โดยตรง คุณจะต้องกำหนดค่าเล็กน้อย
คุณอาจรู้อยู่แล้วว่าคุณสามารถปิดใช้งานการสร้าง rdoc/ri เมื่อคุณเรียกใช้การติดตั้ง gem โดยผ่านแฟล็กบางอย่าง
gem install honeybadger --no-rdoc --no-ri # The old, deprecated way
gem install honeybadger --no-document # The new way
คุณยังสามารถบอกให้ rubygems ใช้แฟล็กเหล่านี้เป็นค่าเริ่มต้นได้ เพียงเพิ่มบรรทัดต่อไปนี้ในไฟล์ ~/.gemrc ของคุณ:
gem: --no-document
แต่ถ้าคุณกำลังวางแผนการเดินทางไปแคมป์ปิ้งและต้องการหยิบเอกสารในท้องที่ล่ะ สร้างเองได้ไม่มีปัญหา
gem rdoc --all --overwrite # regen all docs
gem rdoc honeybadger # generate docs for one gem
ระวังถ้าคุณเลือกที่จะสร้างเอกสารทั้งหมดของคุณใหม่ มันอาจจะใช้เวลาสักครู่. :)
