Apie Pakeitimų žurnalo (Changelog) kūrėjas — Išsamus vadovas
Pakeitimų žurnalo (Changelog) generatorius analizuoja neapdorotus Git pakeitimų (commit) žurnalus ir suformatuoja juos į standartizuotą, išleidimui parengtą `CHANGELOG.md` dokumentaciją. Jis atpažįsta tiek Conventional Commits sintaksę, tiek įprastus pakeitimų pranešimus.
Pakeitimai sugrupuojami į struktūrizuotas kategorijas: funkcijos (Features), klaidų taisymai (Bug Fixes), našumo patobulinimai (Performance Improvements), dokumentacija (Documentation) ir pertvarkymas (Refactoring). Nurodykite laidos versijos žymas bei datas, atfiltruokite suliejimo (merge) pakeitimus ir eksportuokite Markdown formatu vienu paspaudimu.
Pagrindinės funkcijos ir galimybės
- Tiesiogiai analizuoja standartinės terminalo komandos `git log --oneline` išvestį
- Automatiškai klasifikuoja pakeitimus pagal Conventional Commit tipus (feat, fix, perf, docs)
- Konfigūruojamos versijos žymos ir datų antraštės, atitinkančios Keep a Changelog standartus
- Atfiltruoja perteklinius suliejimo (merge) pakeitimus ir sugeneruoja tvarkingą, kopijuoti paruoštą Markdown kodą
Kaip naudoti
- 1
Paleiskite `git log --oneline` savo saugyklos terminale ir įklijuokite žurnalus į įvesties lauką.
- 2
Įveskite tikslinę laidos versiją (pvz., `v1.2.0`) ir pasirinkite išleidimo datą.
- 3
Peržiūrėkite suskirstytas laidos pastabas ir spustelėkite Kopijuoti arba atsisiųskite `CHANGELOG.md`.
Dažniausi naudojimo atvejai
- → Išleidimo pastabų rengimas GitHub Releases prieš diegiant gamybinius atnaujinimus
- → Centralizuoto istorinio CHANGELOG.md failo palaikymas atvirojo kodo saugyklose
- → Glaustų techninių pakeitimų vertimas į suprantamus pakeitimų žurnalus produkto suinteresuotosioms šalims
Susiję įrankiai
HTML meta žymų ir SEO generatorius
Generuokite teisingas HTML meta žymas, Open Graph ir Twitter Cards socialiniams tinklams ir paieškai.
Gitignore failų generatorius
Generuokite išsamius .gitignore failus pagal operacinę sistemą, kalbą ir kūrimo įrankį.
Atvirojo kodo licencijų generatorius
Pasirinkite ir generuokite MIT, Apache 2.0, GPL, BSD ir kitas atvirojo kodo licencijas savo projektui.
README failų kūrimo priemonė
Kurkite profesionalius projekto README.md dokumentus su ženkliukais, skiltimis ir instrukcijomis.
Conventional Commits formavimo priemonė
Formatuokite standartizuotus Git commit pranešimus pagal Conventional Commits standartą.
Semver versijų skaičiuotuvas
Apskaičiuokite kitą semantinę versiją (major, minor, patch) ir patikrinkite atitiktį rėžiams.
Dažniausiai užduodami klausimai ir privatumas
Kaip gauti pakeitimus, atliktus nuo paskutinės versijos žymos?
Terminale paleiskite `git log <previous-tag>..HEAD --oneline`, kad išskirtumėte pakeitimus, atliktus po ankstesnio leidimo.
Kaip klasifikuojami pakeitimai, neatitinkantys Conventional Commits standarto?
Pakeitimai be standartinių priešdėlių sugrupuojami skiltyje „Kiti pakeitimai“ (Other Changes), todėl jokia informacija neprarandama.