keep a changelog

如果你构建了软件,请编写一份更新日志。「If you build software, keep a changelog.」

Github stars Tracking Chart

Keep a Changelog v1.1.0 badge Version 1.1.0 Badge MIT License Badge

Don’t let your friends dump git logs into changelogs™

This repository generates https://keepachangelog.com/.

Development

Dependencies

Installation

  • git clone https://github.com/olivierlacan/keep-a-changelog.git
  • cd keep-a-changelog
  • bundle install
  • bundle exec middleman starts the local development server at http://localhost:4567

Docker

  • git clone https://github.com/olivierlacan/keep-a-changelog.git
  • cd keep-a-changelog
  • docker build -t keep-a-changelog .
  • docker run -p 4567:4567 keep-a-changelog starts the docker development server and binds it at http://localhost:4567

Deployment

  • bundle exec rake publish builds and pushes to the gh-pages branch

Translations

Create a new directory in source/ named after the ISO 639-1 code
for the language you wish to translate Keep a Changelog to. For example,
assuming you want to translate to French Canadian:

  • create the source/fr-CA directory.
  • duplicate the source/en/1.0.0/index.html.haml file in source/fr-CA.
  • edit source/fr-CA/1.0.0/index.html.haml until your translation is ready.
  • commit your changes to your own fork
  • submit a Pull Request with your changes

It may take some time to review your submitted Pull Request. Try to involve a
few native speakers of the language you're translating to in the Pull Request
comments. They'll help review your translation for simple mistakes and give us
a better idea of whether your translation is accurate.

Contribute

Please do contribute! Issues and pull requests are welcome.

Thank you for your help improving software one changelog at a time!

Main metrics

Overview
Name With Ownerolivierlacan/keep-a-changelog
Primary LanguageHaml
Program languageRuby (Language Count: 4)
Platform
License:MIT License
所有者活动
Created At2014-05-31 05:23:54
Pushed At2025-07-01 07:33:25
Last Commit At
Release Count14
Last Release Namev1.1.1 (Posted on 2023-03-06 00:42:27)
First Release Namev0.0.1 (Posted on 2014-12-12 20:29:26)
用户参与
Stargazers Count6.3k
Watchers Count94
Fork Count3.6k
Commits Count614
Has Issues Enabled
Issues Count242
Issue Open Count24
Pull Requests Count230
Pull Requests Open Count11
Pull Requests Close Count79
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private