אודות מחולל יומן שינויים (Changelog) — מדריך מפורט
מחולל יומן השינויים (Changelog Generator) מנתח יומני Git commit גולמיים ומעצב אותם לקובץ תיעוד `CHANGELOG.md` תקני ומוכן להפצה. הכלי תומך בתחביר Conventional Commits וכן בהודעות commit סטנדרטיות.
ה-commits מקובצים לקטגוריות מובנות: תכונות חדשות (Features), תיקוני באגים (Bug Fixes), שיפורי ביצועים (Performance Improvements), תיעוד (Documentation) וריפקטורינג (Refactoring). ניתן להגדיר תגיות גרסת הפצה ותאריכים, לסנן הודעות merge commits ולייצא קובץ Markdown בלחיצה אחת.
תכונות ויכולות עיקריות
- מנתח ישירות פלט מפקודות מסוף מקוריות מסוג `git log --oneline`
- מסווג רשומות commit באופן אוטומטי לפי סוגי Conventional Commit (כגון feat, fix, perf, docs)
- באנרים מותאמים אישית לתגיות גרסת שחרור ותאריכים בהתאם לתקני Keep a Changelog
- מסנן הודעות merge commits מרעישות ומייצר קוד Markdown נקי המוכן להעתקה והדבקה
כיצד להשתמש
- 1
הרץ `git log --oneline` במסוף המאגר שלך והדבק את היומנים בשדה הקלט.
- 2
הזן את גרסת היעד לשחרור (למשל `v1.2.0`) ובחר תאריך שחרור.
- 3
סקור את הערות השחרור המסווגות ולחץ על העתק או הורד את `CHANGELOG.md`.
שימושים נפוצים
- ← הרכבת הערות שחרור (release notes) עבור GitHub Releases לפני פריסת עדכונים לייצור
- ← תחזוקת קובץ CHANGELOG.md היסטורי ומרכזי עבור מאגרי קוד פתוח
- ← תרגום רשימת commits טכנית ועמוסה ליומני שינויים קריאים עבור בעלי עניין ומנהלי מוצר
כלים קשורים
מחולל תגיות Meta (SEO)
יצירת תגיות מטא מלאות עבור Open Graph, Twitter Cards ותגיות SEO בסיסיות.
מחולל .gitignore
יצירת קובצי .gitignore מותאמים אישית לשפות פיתוח, סביבות עבודה ומערכות הפעלה.
מחולל רישיונות קוד פתוח
יצירת קובצי רישיון פופולריים (MIT, Apache 2.0, GPL v3, BSD) עם פרטי הפרויקט.
מחולל README.md
יצירת תבנית README מקיפה ומעוצבת לפרויקטים בקוד פתוח עם סמלילים ותיאורים.
מחולל הודעות Conventional Commits
יצירת הודעות Git Commit תקניות לפי מפרט Conventional Commits (feat, fix, chore וכו').
מחשבון גרסאות SemVer
חישוב ובדיקת גרסאות סמנטיות (Semantic Versioning), טווחי תאימות ושדרוגים.
שאלות נפוצות ופרטיות
כיצד ניתן לחלץ הודעות commit מאז תגית השחרור האחרונה?
הרץ במסוף שלך את הפקודה `git log <previous-tag>..HEAD --oneline` כדי לבודד את ה-commits שנוצרו אך ורק לאחר הגרסה הקודמת.
כיצד מסווגים commits שאינם בתחביר conventional?
commits ללא קידומת conventional מקובצים תחת סעיף "Other Changes", מה שמבטיח ששום מידע על commit לא ילך לאיבוד.