מחולל יומן שינויים (Changelog)

יצירת קובץ CHANGELOG.md מעוצב ומסודר מתוך הודעות Git Commit.

נותחו 0 Conventional Commits

אודות מחולל יומן שינויים (Changelog) — מדריך מפורט

קטגוריה: DevOps ותקנים 100% מקומי בדפדפן

מחולל יומן השינויים (Changelog Generator) מנתח יומני Git commit גולמיים ומעצב אותם לקובץ תיעוד `CHANGELOG.md` תקני ומוכן להפצה. הכלי תומך בתחביר Conventional Commits וכן בהודעות commit סטנדרטיות.

ה-commits מקובצים לקטגוריות מובנות: תכונות חדשות (Features), תיקוני באגים (Bug Fixes), שיפורי ביצועים (Performance Improvements), תיעוד (Documentation) וריפקטורינג (Refactoring). ניתן להגדיר תגיות גרסת הפצה ותאריכים, לסנן הודעות merge commits ולייצא קובץ Markdown בלחיצה אחת.

#changelog #git #release #version #history

תכונות ויכולות עיקריות

  • מנתח ישירות פלט מפקודות מסוף מקוריות מסוג `git log --oneline`
  • מסווג רשומות commit באופן אוטומטי לפי סוגי Conventional Commit (כגון feat, fix, perf, docs)
  • באנרים מותאמים אישית לתגיות גרסת שחרור ותאריכים בהתאם לתקני Keep a Changelog
  • מסנן הודעות merge commits מרעישות ומייצר קוד Markdown נקי המוכן להעתקה והדבקה

כיצד להשתמש

  1. 1

    הרץ `git log --oneline` במסוף המאגר שלך והדבק את היומנים בשדה הקלט.

  2. 2

    הזן את גרסת היעד לשחרור (למשל `v1.2.0`) ובחר תאריך שחרור.

  3. 3

    סקור את הערות השחרור המסווגות ולחץ על העתק או הורד את `CHANGELOG.md`.

שימושים נפוצים

  • ← הרכבת הערות שחרור (release notes) עבור GitHub Releases לפני פריסת עדכונים לייצור
  • ← תחזוקת קובץ CHANGELOG.md היסטורי ומרכזי עבור מאגרי קוד פתוח
  • ← תרגום רשימת commits טכנית ועמוסה ליומני שינויים קריאים עבור בעלי עניין ומנהלי מוצר

כלים קשורים

שאלות נפוצות ופרטיות

כיצד ניתן לחלץ הודעות commit מאז תגית השחרור האחרונה?

הרץ במסוף שלך את הפקודה `git log <previous-tag>..HEAD --oneline` כדי לבודד את ה-commits שנוצרו אך ורק לאחר הגרסה הקודמת.

כיצד מסווגים commits שאינם בתחביר conventional?

commits ללא קידומת conventional מקובצים תחת סעיף "Other Changes", מה שמבטיח ששום מידע על commit לא ילך לאיבוד.