حول مولد سجل التغييرات Changelog — الدليل التفصيلي
يقوم مولّد سجل التغييرات (Changelog Generator) بتحليل سجلات إيداعات Git وتنسيقها في وثيقة `CHANGELOG.md` قياسية جاهزة للإصدار. وهو يدعم صياغة Conventional Commits بالإضافة إلى رسائل الإيداع العادية.
تُصنف الإيداعات في فئات مهيكلة: الميزات الجديدة (Features)، وإصلاح الأخطاء (Bug Fixes)، وتحسينات الأداء (Performance Improvements)، والتوثيق (Documentation)، وإعادة هيكلة التعليمات البرمجية (Refactoring). كما يتيح ضبط وسوم إصدار التوزيعة وتواريخها، مع استبعاد إيداعات الدمج (Merge commits) للتصدير الفوري بصيغة Markdown.
الميزات والقدرات الرئيسية
- تحليل مباشر لمخرجات الأمر `git log --oneline` من الطرفية
- تصنيف تلقائي لمدخلات الإيداع وفقاً لأنواع Conventional Commits القياسية (مثل feat وfix وperf وdocs)
- عناوين إصدار وتاريخ قابلة للتخصيص متوافقة مع معايير Keep a Changelog
- استبعاد إيداعات الدمج المشوشة وإنتاج كود Markdown نظيف وجاهز للنسخ المباشر
طريقة الاستخدام
- 1
نفّذ الأمر `git log --oneline` في طرفية المستودع الخاص بك والصق السجلات في حقل الإدخال.
- 2
أدخل إصدار الإصدار المستهدف (مثل `v1.2.0`) وحدد تاريخ الإصدار.
- 3
راجع ملاحظات الإصدار المصنفة وانقر على نسخ أو تنزيل ملف `CHANGELOG.md`.
حالات الاستخدام الشائعة
- ← تجميع ملاحظات الإصدار لإصدارات GitHub Releases قبل نشر التحديثات على بيئة الإنتاج
- ← الحفاظ على ملف CHANGELOG.md تاريخي ومركزي للمستودعات مفتوحة المصدر
- ← تحويل سجلات الإيداعات التقنية المعقدة إلى سجل تغييرات سهل القراءة لأصحاب المصلحة في المنتج
أدوات ذات صلة
مولد وسوم SEO و Open Graph
توليد وسوم HTML الوصفية و Open Graph و بطاقات Twitter لتحسين ظهور المواقع في محركات البحث.
مولد ملف .gitignore
إنشاء ملفات .gitignore المخصصة للغات الأطر البرمجية المختلفة (Node و Python و Rust و Go).
مولد تراخيص المصادر المفتوحة
إنشاء نصوص التراخيص مفتوحة المصدر (MIT و Apache 2.0 و GPLv3 و BSD) مع حقوق النشر.
مولد ملف README لمشاريع Git
توليد قوالب ملفات README احترافية للمشاريع مفتوحة المصدر مع الشارات والإرشادات.
منشئ رسائل Conventional Commits
صياغة رسائل التعديل لـ Git وفقاً لمعيار Conventional Commits بدقة وتنظيم.
حاسبة ترقيم الإصدارات SemVer
مقارنة وحساب نطاقات ترقيم الإصدارات الدلالية (SemVer) وحل تعارضات الحزم.
الأسئلة الشائعة والخصوصية
كيف يمكنني استخراج الإيداعات التي تمت منذ آخر وسم إصدار (Release Tag)؟
نفّذ الأمر `git log <previous-tag>..HEAD --oneline` في الطرفية لعزل الإيداعات التي تمت حصراً بعد الإصدار السابق.
كيف يتم تصنيف الإيداعات التي لا تتبع معيار Conventional Commits؟
تُجمع الإيداعات التي تفتقر إلى البادئات القياسية في قسم "Other Changes" (تغييرات أخرى)، لضمان عدم إغفال أي معلومة من سجل الإيداعات.