Giới thiệu Tạo nhật ký thay đổi Changelog — Hướng dẫn chi tiết
Trình tạo Changelog (Changelog Generator) phân tích cú pháp nhật ký commit Git thô và định dạng chúng thành tài liệu `CHANGELOG.md` tiêu chuẩn, sẵn sàng cho các bản phát hành. Công cụ hỗ trợ cú pháp Conventional Commits cũng như các thông điệp commit thông thường.
Các commit được phân nhóm thành các danh mục có cấu trúc: Features, Bug Fixes, Performance Improvements, Documentation và Refactoring. Dễ dàng cấu hình thẻ tag phiên bản và ngày phát hành, đồng thời lọc bỏ các merge commit để xuất Markdown chỉ với một cú nhấp chuột.
Tính năng và khả năng nổi bật
- Phân tích cú pháp trực tiếp đầu ra từ lệnh dòng lệnh nguyên bản `git log --oneline`
- Tự động phân loại các mục commit theo các kiểu Conventional Commit (feat, fix, perf, docs)
- Tùy chỉnh biểu ngữ thẻ phiên bản và ngày phát hành tuân thủ tiêu chuẩn Keep a Changelog
- Lọc bỏ các commit hợp nhất (merge commit) gây nhiễu và xuất ra định dạng Markdown sạch sẽ, sẵn sàng sao chép
Cách sử dụng
- 1
Chạy lệnh `git log --oneline` trong terminal của kho lưu trữ và dán nhật ký commit vào ô nhập liệu.
- 2
Nhập phiên bản phát hành mục tiêu của bạn (ví dụ: `v1.2.0`) và chọn ngày phát hành.
- 3
Xem lại ghi chú phát hành đã được phân loại và nhấp vào Sao chép hoặc tải xuống `CHANGELOG.md`.
Trường hợp sử dụng phổ biến
- → Tổng hợp ghi chú phát hành cho GitHub Releases trước khi triển khai các bản cập nhật production
- → Duy trì tệp CHANGELOG.md lịch sử tập trung cho các kho mã nguồn mở
- → Chuyển đổi các commit kỹ thuật phức tạp thành nhật ký thay đổi dễ hiểu cho các bên liên quan về sản phẩm
Công cụ liên quan
Tạo thẻ Meta SEO & OpenGraph
Tạo bộ thẻ meta chuẩn cho SEO, OpenGraph (Facebook) và Twitter Card với trình xem trước trực quan.
Tạo tệp .gitignore
Tạo tệp .gitignore hoàn chỉnh cho Node.js, Python, Java, Go, Rust, macOS, Windows và IDE.
Tạo giấy phép mã nguồn mở
Chọn và tạo văn bản giấy phép mã nguồn mở phổ biến (MIT, Apache 2.0, GPL 3.0, BSD) với thông tin bản quyền.
Tạo tài liệu README.md
Tạo tệp tài liệu README.md chuyên nghiệp cho dự án với các huy hiệu (Badges), hướng dẫn cài đặt và cấu trúc mã nguồn.
Soạn thảo Conventional Commits
Trình soạn thảo thông điệp commit chuẩn hóa theo quy ước Conventional Commits (feat, fix, docs, chore).
Tính toán phiên bản SemVer
Phân tích, so sánh và kiểm tra quy tắc phạm vi phiên bản phần mềm theo tiêu chuẩn Semantic Versioning.
Câu hỏi thường gặp và quyền riêng tư
Làm thế nào để trích xuất các commit kể từ thẻ phát hành gần nhất?
Chạy lệnh `git log <previous-tag>..HEAD --oneline` trong terminal của bạn để tách riêng các commit được tạo sau bản phát hành trước.
Các commit không tuân theo quy chuẩn (non-conventional) được phân loại như thế nào?
Các commit thiếu tiền tố quy chuẩn sẽ được nhóm vào phần "Other Changes", đảm bảo không bỏ sót bất kỳ thông tin commit nào.