Dark mode
คู่มือคำสั่ง CLI ของ VitePress
VitePress มีเครื่องมือบรรทัดคำสั่ง (CLI) ที่ใช้งานง่ายและทรงพลัง สำหรับจัดการเว็บไซต์เอกสารของคุณ ด้านล่างนี้คือคำสั่งหลักและตัวเลือกที่สำคัญ
vitepress dev
เริ่มเซิร์ฟเวอร์สำหรับพัฒนาเว็บไซต์ VitePress โดยใช้ไดเรกทอรีที่กำหนดเป็น root (ค่าปกติคือไดเรกทอรีปัจจุบัน) สามารถละเว้นคำว่า dev ได้หากทำงานในไดเรกทอรีปัจจุบัน
วิธีใช้
bash
# เริ่มในไดเรกทอรีปัจจุบัน (ไม่ต้องใส่ `dev`)
vitepress
# เริ่มในโฟลเดอร์ย่อย
vitepress dev [root]ตัวเลือก
| ตัวเลือก | คำอธิบาย |
|---|---|
--open [path] | เปิดเบราว์เซอร์โดยอัตโนติเมื่อเริ่มต้น (boolean หรือ string) |
--port <port> | ระบุพอร์ตที่ต้องการ (ตัวเลข) |
--base <path> | กำหนด public base path (ค่าเริ่มต้น: /) (string) |
--cors | เปิดใช้งาน CORS |
--strictPort | ออกจากโปรแกรมหากพอร์ตที่ระบุถูกใช้งานอยู่ (boolean) |
--force | บังคับให้ optimizer ไม่ใช้ cache และ re-bundle ใหม่ (boolean) |
vitepress build
สร้างเว็บไซต์ VitePress สำหรับนำไปใช้งานจริง (production)
วิธีใช้
bash
vitepress build [root]ตัวเลือก
| ตัวเลือก | คำอธิบาย |
|---|---|
--mpa (experimental) | สร้างแบบ MPA โดยไม่ใช้ client-side hydration (boolean) |
--base <path> | กำหนด public base path (ค่าเริ่มต้น: /) (string) |
--target <target> | ระบุ transpile target (ค่าเริ่มต้น: modules) (string) |
--outDir <dir> | โฟลเดอร์สำหรับไฟล์ output (ค่าเริ่มต้น: <root>/.vitepress/dist) (string) |
--minify [minifier] | เปิด/ปิดการบีบอัดไฟล์ หรือระบุ minifier ที่ต้องการ (ค่าเริ่มต้น: esbuild) |
--assetsInlineLimit <n> | กำหนดขนาดสูงสุดของ asset ที่จะ inline เป็น base64 (ค่าเริ่มต้น: 4096 ไบต์) (number) |
vitepress preview
แสดงตัวอย่างเว็บไซต์ที่ build แล้วแบบ local (เสมือน production)
วิธีใช้
bash
vitepress preview [root]ตัวเลือก
| ตัวเลือก | คำอธิบาย |
|---|---|
--base <path> | กำหนด public base path (ค่าเริ่มต้น: /) (string) |
--port <port> | ระบุพอร์ตที่ต้องการ (ตัวเลข) |
vitepress init
เริ่มต้นตัวช่วยตั้งค่า (setup wizard) ในไดเรกทอรีปัจจุบัน
วิธีใช้
bash
vitepress initดูรายละเอียดเพิ่มเติมและการใช้งานขั้นสูงได้ที่ เอกสารทางการ VitePress