مولد سجل التغييرات Changelog

توليد سجلات التغيير المنظمة بصيغة Keep a Changelog للإصدارات البرمجية الجديدة.

تم تحليل 0 إيداع وفق Conventional Commits

حول مولد سجل التغييرات Changelog — الدليل التفصيلي

الفئة: DevOps والمعايير معالجة محلية 100% في المتصفح

يقوم مولّد سجل التغييرات (Changelog Generator) بتحليل سجلات إيداعات Git وتنسيقها في وثيقة `CHANGELOG.md` قياسية جاهزة للإصدار. وهو يدعم صياغة Conventional Commits بالإضافة إلى رسائل الإيداع العادية.

تُصنف الإيداعات في فئات مهيكلة: الميزات الجديدة (Features)، وإصلاح الأخطاء (Bug Fixes)، وتحسينات الأداء (Performance Improvements)، والتوثيق (Documentation)، وإعادة هيكلة التعليمات البرمجية (Refactoring). كما يتيح ضبط وسوم إصدار التوزيعة وتواريخها، مع استبعاد إيداعات الدمج (Merge commits) للتصدير الفوري بصيغة Markdown.

#changelog #git #release #version #history

الميزات والقدرات الرئيسية

  • تحليل مباشر لمخرجات الأمر `git log --oneline` من الطرفية
  • تصنيف تلقائي لمدخلات الإيداع وفقاً لأنواع Conventional Commits القياسية (مثل feat وfix وperf وdocs)
  • عناوين إصدار وتاريخ قابلة للتخصيص متوافقة مع معايير Keep a Changelog
  • استبعاد إيداعات الدمج المشوشة وإنتاج كود Markdown نظيف وجاهز للنسخ المباشر

طريقة الاستخدام

  1. 1

    نفّذ الأمر `git log --oneline` في طرفية المستودع الخاص بك والصق السجلات في حقل الإدخال.

  2. 2

    أدخل إصدار الإصدار المستهدف (مثل `v1.2.0`) وحدد تاريخ الإصدار.

  3. 3

    راجع ملاحظات الإصدار المصنفة وانقر على نسخ أو تنزيل ملف `CHANGELOG.md`.

حالات الاستخدام الشائعة

  • ← تجميع ملاحظات الإصدار لإصدارات GitHub Releases قبل نشر التحديثات على بيئة الإنتاج
  • ← الحفاظ على ملف CHANGELOG.md تاريخي ومركزي للمستودعات مفتوحة المصدر
  • ← تحويل سجلات الإيداعات التقنية المعقدة إلى سجل تغييرات سهل القراءة لأصحاب المصلحة في المنتج

أدوات ذات صلة

الأسئلة الشائعة والخصوصية

كيف يمكنني استخراج الإيداعات التي تمت منذ آخر وسم إصدار (Release Tag)؟

نفّذ الأمر `git log <previous-tag>..HEAD --oneline` في الطرفية لعزل الإيداعات التي تمت حصراً بعد الإصدار السابق.

كيف يتم تصنيف الإيداعات التي لا تتبع معيار Conventional Commits؟

تُجمع الإيداعات التي تفتقر إلى البادئات القياسية في قسم "Other Changes" (تغييرات أخرى)، لضمان عدم إغفال أي معلومة من سجل الإيداعات.