Source

เครื่องมือสร้าง

เรียนรู้วิธีใช้สคริปต์ npm ของ Bootstrap เพื่อสร้างเอกสารประกอบ คอมไพล์ซอร์สโค้ด เรียกใช้การทดสอบ และอื่นๆ

การตั้งค่าเครื่องมือ

Bootstrap ใช้สคริปต์ npmสำหรับระบบ บิลด์ package.jsonของเรามีวิธีการที่สะดวกในการทำงานกับเฟรมเวิร์ก รวมถึงการคอมไพล์โค้ด การทดสอบการทำงาน และอื่นๆ

ในการใช้ระบบบิลด์ของเราและเรียกใช้เอกสารของเราในเครื่อง คุณจะต้องมีสำเนาของไฟล์ต้นทางของ Bootstrap และ Node.js ทำตามขั้นตอนเหล่านี้และคุณควรพร้อมที่จะเขย่า:

  1. ดาวน์โหลดและติดตั้ง Node.jsซึ่งเราใช้ในการจัดการการขึ้นต่อกันของเรา
  2. ไปที่/bootstrapไดเร็กทอรีรูทและรันnpm installเพื่อติดตั้งการขึ้นต่อกันในเครื่องของเราที่แสดงอยู่ในpackage.json
  3. ติดตั้ง 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 เทมเพลต และอื่นๆ วิธีเริ่มต้นมีดังนี้

  1. เรียกใช้การตั้งค่าเครื่องมือด้านบนเพื่อติดตั้ง Jekyll (ตัวสร้างไซต์) และการพึ่งพา Ruby อื่นๆ ด้วยbundle install.
  2. จากไดเร็กทอรี root /bootstrapให้รันnpm run docs-serveในบรรทัดคำสั่ง
  3. เปิดhttp://localhost:9001ในเบราว์เซอร์ของคุณและ voila

เรียนรู้เพิ่มเติมเกี่ยวกับการใช้ Jekyll โดยการอ่านเอกสารประกอบ

การแก้ไขปัญหา

หากคุณประสบปัญหาในการติดตั้งการพึ่งพา ให้ถอนการติดตั้งเวอร์ชันการพึ่งพาก่อนหน้าทั้งหมด (ทั่วโลกและในเครื่อง) แล้วรันnpm installใหม่