การแสดงตัวอย่างในเครื่องสำหรับผู้เขียนเนื้อหา

แสดงตัวอย่างเอกสารในเครื่องก่อนที่จะ push การเปลี่ยนแปลง สิ่งที่คุณต้องมีคือ Docker และไดเรกทอรี docs/

ข้อกำหนดเบื้องต้น

ติดตั้งและเปิดใช้งาน Docker Desktop แล้ว
clone รีโปเนื้อหาของคุณมาไว้ในเครื่องโดยมีไดเรกทอรี docs/ ที่มีไฟล์ index.mdx อย่างน้อยหนึ่งไฟล์

จากรากของรีโปเนื้อหาของคุณ ให้รัน:

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

เปิด http://localhost:4321 เมื่อเซิร์ฟเวอร์เริ่มทำงานแล้ว

วางรูปภาพไว้ในไดเรกทอรีย่อย เช่น docs/images/ คอนเทนเนอร์จะตรวจจับสิ่งเหล่านี้โดยอัตโนมัติ — ไม่จำเป็นต้องเมานต์วอลุ่มเพิ่มเติม

อ้างอิงในไฟล์ MDX ของคุณด้วยเส้นทางสัมพันธ์จากราก:

![Architecture diagram](/images/architecture.png)

พอร์ตถูกใช้งานอยู่แล้ว — แมปไปยังพอร์ตโฮสต์อื่น: -p 8080:4321 จากนั้นเปิด http://localhost:8080

เนื้อหาไม่แสดง — ตรวจสอบว่ามีไฟล์ docs/index.mdx อยู่ ตรวจสอบเอาต์พุตของคอนเทนเนอร์ว่ามีข้อความ ERROR: No content found หรือไม่

อิมเมจเก่า — ดึงเวอร์ชันล่าสุด:

docker pull ghcr.io/f5-sales-demo/docs-builder:latest

Docker Build — รายละเอียดอิมเมจ ตัวแปรสภาพแวดล้อม และการ build สำหรับ production
สถาปัตยกรรม — โมเดลการฉีดเนื้อหาและการออกแบบระบบธีม