Create a markdown changelog from your git repository (without GitHub).
The simplest way to install, is to run the installation script:
$ curl -Ls get.dannyb.co/git-changelog/setup | bash
It will:
/usr/local/bin/git-changelog
/usr/local/share/man/man1/git-changelog.1
If you prefer to install manually:
/usr/local/bin
), and make it executable./usr/local/share/man/man1
.The changelog in this repository was generated with
git changelog
.
Run git changelog
in any compatible git repository. It will print a
markdown changelog using these rules:
git log
events by tagv
followed by a digit (v1.2.3
)1.2.3
)"- Fixed something"
)When using --save
, you can include manually edited content in the
CHANGELOG.md
file. To do so, add a marker in the following format to your
CHANGELOG.md
file:
<!-- break v1.2.3 -->
This will make git changelog --save
perform the following actions:
v1.2.3
. Since tags areCHANGELOG.md
file starting from the markerCHANGELOG.md
.See this CHANGELOG.md file as an example.
Note that this only makes sense when using --save
or
--reverse --out FILE.md
.
git-changelog
can add two types of links to your change log:
Set the environment variable CHANGELOG_COMMIT_URL
to a URL. %h
will be
replaced with the short commit hash, and %H
with the long commit hash:
export CHANGELOG_COMMIT_URL=https://github.com/DannyBen/git-changelog/commit/%h
Set the environment variable CHANGELOG_COMPARE_URL
to a URL. %s
will be
replaced with the git ref range (e.g. v1.0..v1.1
):
export CHANGELOG_COMPARE_URL=https://github.com/dannyben/git-changelog/compare/%s
$ curl -Ls get.dannyb.co/git-changelog/uninstall | bash
If you experience any issue, have a question or a suggestion, or if you wish to contribute, feel free to open an issue.