ข้ามไปที่เนื้อหาหลัก ข้ามไปที่การนำทางเอกสาร
in English

มีส่วนช่วย

ช่วยพัฒนา Bootstrap ด้วยสคริปต์การสร้างและการทดสอบเอกสารของเรา

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

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

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

  1. ดาวน์โหลดและติดตั้ง Node.jsซึ่งเราใช้ในการจัดการการขึ้นต่อกันของเรา
  2. ดาวน์โหลดซอร์สของ Bootstrapหรือfork ที่เก็บ Bootstrap
  3. ไปที่/bootstrapไดเร็กทอรีรูทและรันnpm installเพื่อติดตั้งการขึ้นต่อกันในเครื่องของเราที่แสดงอยู่ในpackage.json

เมื่อเสร็จแล้ว คุณจะสามารถเรียกใช้คำสั่งต่างๆ ที่ให้มาจากบรรทัดคำสั่งได้

การใช้สคริปต์ npm

package.jsonของเรามีงานมากมายในการพัฒนาโครงการ เรียกใช้npm runเพื่อดูสคริปต์ npm ทั้งหมดในเทอร์มินัลของคุณ งานหลัก ได้แก่ :

งาน คำอธิบาย
npm start คอมไพล์ CSS และ JavaScript สร้างเอกสาร และเริ่มเซิร์ฟเวอร์ในเครื่อง
npm run dist สร้างdist/ไดเร็กทอรีด้วยไฟล์ที่คอมไพล์แล้ว ต้องใช้Sass , Autoprefixerและterser
npm test รันการทดสอบในเครื่องหลังจากรันnpm run dist
npm run docs-serve สร้างและรันเอกสารในเครื่อง
เริ่มต้นกับ Bootstrap ผ่าน npm ด้วยโครงการเริ่มต้นของเรา! ไปที่ที่ เก็บ เทมเพลต twbs/bootstrap-npm-starterเพื่อดูวิธีสร้างและปรับแต่ง Bootstrap ในโครงการ npm ของคุณเอง รวมไอคอนคอมไพเลอร์ Sass, Autoprefixer, Stylelint, PurgeCSS และ Bootstrap

ซาส

Bootstrap ใช้Dart Sassเพื่อรวบรวมไฟล์ต้นฉบับ Sass ของเราเป็นไฟล์ CSS (รวมอยู่ในกระบวนการสร้างของเรา) และเราขอแนะนำให้คุณทำเช่นเดียวกันหากคุณกำลังรวบรวม Sass โดยใช้ไปป์ไลน์สินทรัพย์ของคุณเอง ก่อนหน้านี้เราใช้ Node Sass สำหรับ Bootstrap v4 แต่ LibSass และแพ็คเกจที่สร้างขึ้นด้านบน ซึ่งรวมถึง Node Sass เลิกใช้งานแล้ว

Dart Sass ใช้ความแม่นยำในการปัดเศษ 10 และด้วยเหตุผลด้านประสิทธิภาพจึงไม่อนุญาตให้ปรับค่านี้ เราไม่ลดความแม่นยำนี้ระหว่างการประมวลผล CSS ที่เราสร้างขึ้นเพิ่มเติม เช่น ระหว่างการลดขนาด แต่ถ้าคุณเลือกที่จะลด เราขอแนะนำให้รักษาความแม่นยำไว้อย่างน้อย 6 เพื่อป้องกันปัญหาการปัดเศษของเบราว์เซอร์

คำนำหน้าอัตโนมัติ

Bootstrap ใช้Autoprefixer (รวมอยู่ในกระบวนการสร้างของเรา) เพื่อเพิ่มคำนำหน้าผู้ขายให้กับคุณสมบัติ CSS บางอย่างโดยอัตโนมัติในเวลา บิลด์ การทำเช่นนี้ช่วยเราประหยัดเวลาและโค้ดโดยทำให้เราเขียนส่วนสำคัญของ CSS ได้ในครั้งเดียว โดยไม่จำเป็นต้องใช้มิกซ์อินของผู้ขายเหมือนกับที่พบใน v3

เรารักษารายการเบราว์เซอร์ที่รองรับผ่าน Autoprefixer ในไฟล์แยกต่างหากภายในที่เก็บ GitHub ของเรา ดู.browserslistrcสำหรับรายละเอียด

RTLCSS

Bootstrap ใช้RTLCSSเพื่อประมวลผล CSS ที่คอมไพล์แล้วแปลงเป็น RTL โดยพื้นฐานแล้วจะแทนที่คุณสมบัติการรับรู้ทิศทางแนวนอน (เช่นpadding-left) ด้วยสิ่งที่ตรงกันข้าม ซึ่งช่วยให้เราเขียน CSS ได้เพียงครั้งเดียว และทำการปรับแต่งเล็กน้อยโดยใช้การควบคุม RTLCSS และคำสั่งมูลค่า

เอกสารท้องถิ่น

การเรียกใช้เอกสารของเราในเครื่องต้องใช้ Hugo ซึ่งได้รับการติดตั้งผ่าน แพ็คเกจ Hugo-bin npm Hugo เป็นโปรแกรมสร้างไซต์แบบสแตติกที่รวดเร็วและขยายได้อย่างเห็นได้ชัด ซึ่งมอบ: การรวมพื้นฐาน ไฟล์ที่ใช้ Markdown เทมเพลต และอื่นๆ วิธีเริ่มต้นมีดังนี้

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

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

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

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