Toggle git-blame annotations in Atom.
ctrl-b to activate blame. Alternatively, right click the file you want to blame and select
Toggle Git Blame from the dropdown.
Click on the revision hash in the gutter to visit the configured repository diff site. Hosts supported out of the box are:
If the remote repo has a URL we don't recognize, or if there is no remote named
origin, the commit hash will be copied to the clipboard.
Custom remotes can be set globally via options. See below.
If this option is selected, the
git blame command will be run with
If this option is selected, only the first word of the author's name will be displayed. (If both Show First Names and Show Last Names are enabled, the entire author name will be displayed, regardless of whether it contains only two name parts).
If this option is selected, only the last word of the author's name will be displayed. (If both Show First Names and Show Last Names are enabled, the entire author name will be displayed, regardless of whether it contains only two name parts).
If this option is selected, the commit authors will appear with a unique color to make them easily recognisable.
This plugin will first check to see if your repo is backed by GitHub, Bitbucket, or GitLab so nothing is required if your repo is hosted on one of these.
If its not, you can easily set a custom revision URL string like so:
The URL string should contain the following three placeholder variables wrapped in underscore template delimiters like so:
<%- variable %>.
project- Will be replaced with the name of the project in your remote git repository. For this repo it would be
repo- Will be replaced with the name of the repository. For this repo it would be
revision- Will be replaced with the full git revision hash you clicked on.
I'll use github as an example. Its already supported out of the box, but if it wasn't its custom url string would be:
https://github.com/<%- project %>/<%- repo %>/commit/<%- revision %>
So when you clicked on hash revision 12345 in this git-blame repository, you would visit the following url:
You can also set a custom URL in your git config. If present, it will be used insted of the one in the package settings. You can add or change it with this command:
git config --local atom-git-blame.repositoryUrlTemplate "<%- repo %>.git;a=commit;h=<%- revision %>"
Or by edit your
.git/config and add an entry like this:
[atom-git-blame]repositoryUrlTemplate = "<%- repo %>.git;a=commit;h=<%- revision %>"
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.