เครื่องมือสร้าง
เรียนรู้วิธีใช้สคริปต์ npm ของ Bootstrap เพื่อสร้างเอกสารประกอบ คอมไพล์ซอร์สโค้ด เรียกใช้การทดสอบ และอื่นๆ
การตั้งค่าเครื่องมือ
Bootstrap ใช้สคริปต์ npmสำหรับระบบ บิลด์ package.jsonของเรามีวิธีการที่สะดวกในการทำงานกับเฟรมเวิร์ก รวมถึงการคอมไพล์โค้ด การทดสอบการทำงาน และอื่นๆ
ในการใช้ระบบบิลด์ของเราและเรียกใช้เอกสารของเราในเครื่อง คุณจะต้องมีสำเนาของไฟล์ต้นทางของ Bootstrap และ Node.js ทำตามขั้นตอนเหล่านี้และคุณควรพร้อมที่จะเขย่า:
- ดาวน์โหลดและติดตั้ง Node.jsซึ่งเราใช้ในการจัดการการขึ้นต่อกันของเรา
- ไปที่
/bootstrap
ไดเร็กทอรีรูทและรันnpm install
เพื่อติดตั้งการขึ้นต่อกันในเครื่องของเราที่แสดงอยู่ในpackage.json - ติดตั้ง Rubyติดตั้งBundlerด้วย
gem install bundler
และสุดท้ายbundle install
รัน สิ่งนี้จะติดตั้งการพึ่งพา Ruby ทั้งหมด เช่น Jekyll และปลั๊กอิน- ผู้ใช้ Windows:อ่านคู่มือนี้เพื่อให้ Jekyll ทำงานได้โดยไม่มีปัญหา
เมื่อเสร็จแล้ว คุณจะสามารถเรียกใช้คำสั่งต่างๆ ที่ให้มาจากบรรทัดคำสั่งได้
การใช้สคริปต์ npm
package.jsonของเรามีคำสั่งและงานดังต่อไปนี้:
งาน | คำอธิบาย |
---|---|
npm run dist |
npm run dist สร้าง/dist/ ไดเร็กทอรีด้วยไฟล์ที่คอมไพล์แล้ว ใช้Sass , AutoprefixerและUglifyJS _ |
npm test |
เช่นเดียวnpm run dist กับการทดสอบในพื้นที่ |
npm run docs |
สร้างและเชื่อมโยง CSS และ JavaScript สำหรับเอกสาร จากนั้นคุณสามารถเรียกใช้เอกสารในเครื่องผ่านnpm run docs-serve . |
เรียกใช้npm run
เพื่อดูสคริปต์ npm ทั้งหมด
คำนำหน้าอัตโนมัติ
Bootstrap ใช้Autoprefixer (รวมอยู่ในกระบวนการสร้างของเรา) เพื่อเพิ่มคำนำหน้าผู้ขายให้กับคุณสมบัติ CSS บางอย่างโดยอัตโนมัติในเวลา บิลด์ การทำเช่นนี้ช่วยเราประหยัดเวลาและโค้ดโดยทำให้เราเขียนส่วนสำคัญของ CSS ได้ในครั้งเดียว โดยไม่จำเป็นต้องใช้มิกซ์อินของผู้ขายเหมือนกับที่พบใน v3
เรารักษารายการเบราว์เซอร์ที่รองรับผ่าน Autoprefixer ในไฟล์แยกต่างหากภายในที่เก็บ GitHub ของเรา ดู.browserslistrcสำหรับรายละเอียด
เอกสารท้องถิ่น
การเรียกใช้เอกสารของเราในพื้นที่จำเป็นต้องใช้ Jekyll ซึ่งเป็นเครื่องมือสร้างไซต์แบบคงที่ที่มีความยืดหยุ่นที่เหมาะสมซึ่งให้บริการแก่เรา: การรวมพื้นฐาน ไฟล์ที่ใช้ Markdown เทมเพลต และอื่นๆ วิธีเริ่มต้นมีดังนี้
- เรียกใช้การตั้งค่าเครื่องมือด้านบนเพื่อติดตั้ง Jekyll (ตัวสร้างไซต์) และการพึ่งพา Ruby อื่นๆ ด้วย
bundle install
. - จากไดเร็กทอรี root
/bootstrap
ให้รันnpm run docs-serve
ในบรรทัดคำสั่ง - เปิด
http://localhost:9001
ในเบราว์เซอร์ของคุณและ voila
เรียนรู้เพิ่มเติมเกี่ยวกับการใช้ Jekyll โดยการอ่านเอกสารประกอบ
การแก้ไขปัญหา
หากคุณประสบปัญหาในการติดตั้งการพึ่งพา ให้ถอนการติดตั้งเวอร์ชันการพึ่งพาก่อนหน้าทั้งหมด (ทั่วโลกและในเครื่อง) แล้วรันnpm install
ใหม่