เกี่ยวกับ ตัวสร้างบันทึกการเปลี่ยนแปลง (Changelog) — คู่มือการใช้งาน
เครื่องมือสร้างบันทึกการเปลี่ยนแปลง (Changelog Generator) แยกวิเคราะห์บันทึก Git commit ดิบและจัดรูปแบบให้เป็นเอกสาร `CHANGELOG.md` มาตรฐานที่พร้อมสำหรับการปล่อยเวอร์ชัน รองรับทั้งไวยากรณ์ Conventional Commits และข้อความคอมมิตทั่วไป
คอมมิตจะถูกจัดกลุ่มออกเป็นหมวดหมู่ที่มีโครงสร้างชัดเจน: ฟีเจอร์ (Features), แก้ไขข้อผิดพลาด (Bug Fixes), ปรับปรุงประสิทธิภาพ (Performance Improvements), เอกสาร (Documentation) และการปรับโครงสร้างโค้ด (Refactoring) สามารถกำหนดแท็กเวอร์ชันและวันที่ พร้อมกรองเมิร์จคอมมิตออกเพื่อส่งออกเป็น Markdown ได้ในคลิกเดียว
คุณสมบัติและความสามารถหลัก
- แยกวิเคราะห์เอาต์พุตจากคำสั่งเทอร์มินัล `git log --oneline` ดั้งเดิมได้โดยตรง
- จัดหมวดหมู่รายการคอมมิตโดยอัตโนมัติตามประเภท Conventional Commit (feat, fix, perf, docs)
- กำหนดแท็กเวอร์ชันที่จะปล่อยและแถบวันที่ได้ตามมาตรฐาน Keep a Changelog
- กรองเมิร์จคอมมิต (merge commit) ที่ไม่จำเป็นออก และส่งออกเป็น Markdown ที่สะอาดพร้อมคัดลอกไปใช้งาน
วิธีใช้งาน
- 1
รันคำสั่ง `git log --oneline` ในเทอร์มินัลของที่เก็บข้อมูล (repository) แล้ววางบันทึกลงในช่องอินพุต
- 2
ป้อนเวอร์ชันที่ต้องการปล่อย (เช่น `v1.2.0`) และเลือกวันที่ปล่อยเวอร์ชัน
- 3
ตรวจสอบบันทึกการปล่อยที่จัดหมวดหมู่แล้ว จากนั้นคลิกคัดลอกหรือดาวน์โหลดไฟล์ `CHANGELOG.md`
ตัวอย่างการใช้งานทั่วไป
- → รวบรวมบันทึกการปล่อยสำหรับ GitHub Releases ก่อนปรับใช้การอัปเดตบนระบบ Production
- → ดูแลไฟล์ CHANGELOG.md ส่วนกลางที่บันทึกประวัติการพัฒนาสำหรับโปรเจกต์โอเพนซอร์ส
- → แปลงคอมมิตเชิงเทคนิคที่ซับซ้อนให้กลายเป็นบันทึกการเปลี่ยนแปลงที่อ่านเข้าใจง่ายสำหรับผู้มีส่วนได้ส่วนเสียในผลิตภัณฑ์
เครื่องมือที่เกี่ยวข้อง
ตัวสร้าง Meta Tags สำหรับ SEO
สร้างแท็ก Open Graph, Twitter Cards และ SEO Meta Tags สำหรับเว็บไซต์
ตัวสร้าง .gitignore
สร้างไฟล์ .gitignore มาตรฐานสำหรับภาษา โปรแกรมแก้ไข และเฟรมเวิร์กต่างๆ
ตัวสร้างสัญญาอนุญาตโอเพนซอร์ส
สร้างไฟล์ LICENSE โอเพนซอร์สมาตรฐาน (MIT, Apache 2.0, GPLv3, BSD, ISC)
ตัวสร้างไฟล์ README
สร้างโครงร่างเอกสาร README.md ระดับมืออาชีพสำหรับโปรเจกต์ GitHub พร้อมแบดจ์
ตัวสร้างข้อความ Conventional Commit
สร้างข้อความ Git commit ตามมาตรฐาน Conventional Commits (feat, fix, docs, refactor)
เครื่องคำนวณ Semantic Versioning
เปรียบเทียบเวอร์ชัน ตรวจสอบช่วงเงื่อนไข (Range) และเพิ่มเวอร์ชัน Major/Minor/Patch
คำถามที่พบบ่อยและความเป็นส่วนตัว
ฉันจะแยกดึงเฉพาะคอมมิตที่เกิดขึ้นหลังจากแท็กเวอร์ชันก่อนหน้าได้อย่างไร?
รัน `git log <previous-tag>..HEAD --oneline` ในเทอร์มินัลของคุณ เพื่อแยกเฉพาะคอมมิตที่เกิดขึ้นหลังจากเวอร์ชันก่อนหน้าอย่างแม่นยำ
คอมมิตที่ไม่ได้ใช้รูปแบบ Conventional Commit จะถูกจัดหมวดหมู่อย่างไร?
คอมมิตที่ไม่มีคำนำหน้าตามแบบแผนจะถูกจัดกลุ่มไว้ในส่วน "Other Changes" เพื่อให้มั่นใจว่าจะไม่มีข้อมูลคอมมิตใดตกหล่น