ข้ามไปยังเนื้อหาหลัก

จัดการเวอร์ชันของเอกสาร

Docusaurus สามารถจัดการเอกสารได้หลายเวอร์ชัน

สร้างเวอร์ชันของเอกสาร​

ปล่อยเวอร์ชัน 1.0 ของโปรเจกต์ของคุณ:

npm run docusaurus docs:version 1.0

โฟลเดอร์ docs จะถูกคัดลอกไปยัง versioned_docs/version-1.0 และไฟล์ versions.json จะถูกสร้างขึ้น

ตอนนี้เอกสารของคุณมี 2 เวอร์ชัน:

  • 1.0 ที่ http://localhost:3000/docs/ สำหรับเอกสารเวอร์ชัน 1.0
  • current ที่ http://localhost:3000/docs/next/ สำหรับเอกสารที่กำลังปรับปรุงและยังไม่ได้เผยแพร่

เพิ่มรายการเลือกเวอร์ชัน (Version Dropdown)​

หากต้องการนำทางข้ามเวอร์ชันอย่างราบรื่น ให้เพิ่มรายการเลือกเวอร์ชัน

แก้ไขไฟล์ docusaurus.config.js:

docusaurus.config.js
export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: "docsVersionDropdown",
        },
      ],
    },
  },
};

รายการเลือกเวอร์ชันของเอกสารจะปรากฏในแถบนำทางของคุณ:

รายการเลือกเวอร์ชันเอกสาร

อัปเดตเวอร์ชันที่มีอยู่​

คุณสามารถแก้ไขเอกสารที่มีเวอร์ชันได้ในโฟลเดอร์ที่เกี่ยวข้อง:

  • versioned_docs/version-1.0/hello.md จะอัปเดต http://localhost:3000/docs/hello
  • docs/hello.md จะอัปเดต http://localhost:3000/docs/next/hello