چینج لاگ (Changelog) جنریٹر کے بارے میں — تفصیلی رہنما
Changelog Generator خام Git کمٹ لاگز کو پارس کرتا ہے اور انہیں معیاری، ریلیز کے لیے تیار `CHANGELOG.md` دستاویزات میں فارمیٹ کرتا ہے۔ یہ Conventional Commits کے نحو (syntax) کے ساتھ ساتھ معیاری کمٹ پیغامات کو بھی سمجھتا ہے۔
کمٹس کو منظم زمروں میں تقسیم کیا جاتا ہے: Features، Bug Fixes، Performance Improvements، Documentation، اور Refactoring۔ سنگل کلک Markdown ایکسپورٹ کے لیے مرج کمٹس کو فلٹر کرتے ہوئے ریلیز ورژن ٹیگز اور تاریخیں ترتیب دیں۔
اہم خصوصیات اور صلاحیتیں
- مقامی `git log --oneline` ٹرمینل کمانڈز کے آؤٹ پٹ کو براہ راست پارس کرتا ہے
- Conventional Commit کی اقسام (feat، fix، perf، docs) کے ذریعے کمٹ اندراجات کی خودکار درجہ بندی کرتا ہے
- Keep a Changelog کے معیارات کے مطابق قابلِ ترتیب ریلیز ورژن ٹیگ اور تاریخ کے بینرز
- غیر ضروری مرج کمٹس کو فلٹر کرتا ہے اور صاف ستھرا، کاپی پیسٹ کے قابل Markdown فراہم کرتا ہے
استعمال کرنے کا طریقہ
- 1
اپنے ریپوزٹری ٹرمینل میں `git log --oneline` چلائیں اور لاگز کو ان پٹ فیلڈ میں پیسٹ کریں۔
- 2
اپنا مطلوبہ ریلیز ورژن درج کریں (مثلاً `v1.2.0`) اور ریلیز کی تاریخ منتخب کریں۔
- 3
درجہ بند ریلیز نوٹس کا جائزہ لیں اور Copy پر کلک کریں یا `CHANGELOG.md` ڈاؤن لوڈ کریں۔
عام استعمال کی صورتیں
- ← پروڈکشن اپ ڈیٹس تعینات کرنے سے پہلے GitHub Releases کے لیے ریلیز نوٹس تیار کرنا
- ← اوپن سورس ریپوزٹریز کے لیے ایک مرکزی، تاریخی CHANGELOG.md فائل کو برقرار رکھنا
- ← پروڈکٹ اسٹیک ہولڈرز کے لیے پیچیدہ تکنیکی کمٹس کو پڑھنے کے قابل چینج لاگز میں تبدیل کرنا
متعلقہ ٹولز
HTML میٹا ٹیگز جنریٹر
SEO، Open Graph اور Twitter Cards کے لیے مکمل اور درست HTML میٹا ٹیگز تیار کریں۔
.gitignore فائل جنریٹر
Node.js, Python, Java, Go اور سینکڑوں فریم ورکس کے لیے حسب ضرورت .gitignore تیار کریں۔
اوپن سورس لائسنس جنریٹر
MIT, Apache 2.0, GPL اور BSD سمیت دیگر اوپن سورس لائسنسز کے متن کو حسب ضرورت بنائیں۔
README.md جنریٹر
اپنے اوپن سورس پروجیکٹس کے لیے بیجز اور سیکشنز کے ساتھ بہترین README بنائیں۔
Conventional Commits معاون
معیاری اصولوں کے مطابق پیشہ ورانہ اور منظم Git کمٹ پیغامات تیار کریں۔
SemVer کیلکولیٹر اور رینج چیکر
سیمنٹک ورژننگ رینجز، موازنے اور ورژنز کی مطابقت کا فوری جائزہ لیں۔
اکثر پوچھے گئے سوالات اور رازداری
میں پچھلے ریلیز ٹیگ کے بعد کے کمٹس کیسے نکال سکتا ہوں؟
پچھلی ریلیز کے بعد کیے گئے کمٹس کو الگ کرنے کے لیے اپنے ٹرمینل میں `git log <previous-tag>..HEAD --oneline` چلائیں۔
غیر روایتی (non-conventional) کمٹس کی درجہ بندی کیسے کی جاتی ہے؟
روایتی سابقوں سے محروم کمٹس کو "Other Changes" کے سیکشن کے تحت گروپ کیا جاتا ہے، جس سے یقینی بنتا ہے کہ کوئی بھی کمٹ چھوٹ نہ جائے۔