O orodju Generator sporočil Conventional Commits — Podroben vodnik
Generator sporočil Conventional Commits sestavlja strukturirana sporočila o uveljavitvah Git v skladu s specifikacijo Conventional Commits. Razvijalce vodi skozi izbiro tipa (Type), obsega (Scope), vrstice z zadevo (Subject), izbirnega opisa telesa (Body) in noge s sklici na težave (Footer).
Preprosto označite prelomne spremembe s skladnjo s klicajem (`type!: description`), navedite razrešene zahtevke (`Closes #123`) in ustvarite standardizirana sporočila uveljavitev, ki omogočajo avtomatizirana orodja, kot sta `semantic-release` in samodejni generatorji dnevnikov sprememb.
Ključne funkcije in zmogljivosti
- Popoln katalog tipov: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
- Izbirni vnos obsega (scope) ter sprotni opomniki glede dolžine zadeve in velelniškega načina pisanja
- Preklopnik za prelomne spremembe (Breaking Change) z enim klikom z uveljavitvijo standardne skladnje s klicajem (`!`)
- Samodejni generator noge za povezovanje zahtevkov s kopiranjem ukaza `git commit -m` z enim klikom
Kako uporabljati
- 1
Izberite tip uveljavitve (npr. `feat` za funkcije, `fix` za popravke napak).
- 2
Vnesite izbirni obseg (npr. `api`, `auth`) in kratek opis v velelniku.
- 3
Preglejte sestavljen niz uveljavitve in kopirajte celoten ukaz `git commit` za svoj terminal.
Pogosti primeri uporabe
- → Uvajanje inženirskih ekip v dosledne standarde zgodovine uveljavitev v orodju Git
- → Avtomatizacija povečevanja semantičnih različic in samodejno ustvarjanje opomb ob izdajah v cevovodih CI/CD
- → Označevanje nazaj nezdružljivih prelomnih sprememb API-ja med večjimi posodobitvami knjižnic
Sorodna orodja
Generator meta oznak za SEO in Open Graph
Ustvarjajte oznake SEO, Open Graph (Facebook) in Twitter Cards za optimalno deljenje spletnih strani.
Generator datotek .gitignore
Ustvarite prilagojene datoteke .gitignore za Node.js, Python, Go, Rust, macOS, Windows in priljubljene IDE.
Generator odprtokodnih licenc
Izberite in ustvarite standardne odprtokodne licence (MIT, Apache 2.0, GPL v3, BSD) za svoje projekte.
Generator datotek README.md
Hitro sestavite profesionalne predstavitvene datoteke README.md za projekte na GitHubu s predlogami in značkami.
Kalkulator semantičnega različičenja (SemVer)
Preverjajte in primerjajte različice SemVer ter preizkušajte razpone združljivosti npm.
Pregledovalnik specifikacij OpenAPI
Vizualizirajte in preizkušajte dokumentacijo REST API iz specifikacij OpenAPI / Swagger (JSON ali YAML).
Pogosta vprašanja in zasebnost
Kateri skok semantične različice ustreza posameznemu tipu uveljavitve?
Po standardnih pravilih Conventional Commits tip `fix` sproži skok PATCH, `feat` sproži skok MINOR, vsaka uveljavitev z oznako `BREAKING CHANGE` pa sproži skok MAJOR.
Ali se mora vrstica zadeve končati s piko?
Ne. Najboljše prakse specifikacije Conventional Commits priporočajo kratek stavek v velelniku brez pike na koncu (npr. `feat: allow user avatar upload`).