การเผยแพร่และเว็บไซต์ฉบับเต็ม
แหล่งเดียว สองรูปแบบการอ่าน
Markdown ใน GitHub เป็นแหล่งอ้างอิงหลัก บิลด์เว็บไซต์แสดงเอกสารทั้งหมดโดยตรงที่ proof21.xyz/docs/ GitBook อาจเป็นสำเนาเพื่ออ่านหรือแก้ไขแบบเลือกใช้บนชื่อโฮสต์ฟรี เว็บไซต์ไม่ได้พร็อกซีฟีเจอร์ subdirectory แบบเสียเงินของ GitBook
ไฟล์เหล่านี้ไม่ได้หมายความว่า Git Sync อัตโนมัติ เว็บไซต์สาธารณะ หรือการเปลี่ยนโดเมนเกิดขึ้นแล้ว ต้องซิงก์ GitBook อย่างชัดเจนจนกว่าจะตั้งการเชื่อมต่อ
สร้างและตรวจ
จากรากรีโพซิทอรี ติดตั้งตัวแปลงเอกสารเวอร์ชันที่ระบุและรันตัวสร้าง:
python3 -m pip install -r requirements-web.txt
python3 scripts/build_site.py
python3 scripts/check_site.py
python3 -m http.server 4173 --bind 127.0.0.1 --directory site
ตัวสร้างอ่านรายการอนุญาตใน docs/SUMMARY.md แปลง Markdown เป็น HTML สแตติก คัดลอกแผนภาพ SVG ที่มีเวอร์ชัน และสร้างการค้นหา sitemap, RSS และเอกสารสำหรับเครื่อง ไม่คัดลอก ops/ ข้อมูลลับ หรือรากรีโพซิทอรีไปยังเว็บไซต์สาธารณะ
ไซต์ไม่ใช้ฐานข้อมูลหรือรันไทม์แบบเสียเงิน ไม่ต้องสมัคร Sites โฮสต์สแตติกทั่วไปให้บริการผลลัพธ์ที่บิลด์แล้วได้
การตั้งค่า Vercel
vercel.json ที่รากกำหนดคำสั่งบิลด์และโฟลเดอร์ผลลัพธ์ site นำเข้าด้วยพรีเซ็ต Other และใช้รากรีโพซิทอรีเป็นรากบิลด์ ให้บริการ เฉพาะ site/ ไม่ใช่รากซอร์ส ต้องใช้รากรีโพซิทอรีตอนสร้างเพื่ออ่าน docs/ และ brand/
Vercel Hobby ไม่ใช่สิทธิ์ใช้เชิงพาณิชย์ เลือกแผนที่เหมาะสมหรือโฮสต์อื่น ไม่มีการอนุมัติเปลี่ยนการเรียกเก็บเงินในงานนี้ noindex ไม่ใช่การยืนยันตัวตน ใช้การป้องกันการเข้าถึงในการตรวจพรีวิวส่วนตัว [1]
GitBook แบบฟรี
GitBook Free/Basic เผยแพร่เอกสารสาธารณะบนชื่อโฮสต์ของตนได้ และมี Git Sync กับเอกสารอ่านได้โดยเครื่อง โดเมนกำหนดเองและแบรนด์ขั้นสูงต้องใช้แผนที่รองรับ พื้นที่ทำงานที่ยังไม่เผยแพร่ไม่ต้องซื้อ visitor authentication เพียงเพื่อเก็บร่างเป็นส่วนตัว [2]
โดเมนและลิงก์โซเชียล
origin ที่เลือกคือ proof21.xyz ตั้ง DNS ตามโครงการจริงหลังมีโครงการโฮสต์แล้ว และเก็บระเบียนอีเมลกับการยืนยันเดิมไว้ โดเมน .ai ยังเป็นแผน ไม่ได้ยืนยัน
ปลายทาง X และ LinkedIn เว้นว่างจนเจ้าของให้ URL ที่ถูกต้อง GitHub ยังเป็นส่วนตัว ลิงก์พรีวิวระบุสถานะนี้และบิลด์สาธารณะซ่อนลิงก์ซอร์สส่วนตัว ห้ามใช้ URL ตัวแก้ไข GitBook เป็นลิงก์เอกสารสาธารณะ