More
- Authors: Show the authors for the current file if there isn't a regression.
- Branch: Show available branches.
- Diff: Interactive diff. Command click to navigate to specific lines.
- Document: Show the file history while also considering renames and moves.
- File: Show the file history without considering renames or moves.
- Line: Load the line history asynchronously in the menu.
- Log: Show the log up to a certain predefined amount, which could be larger.
- Message: Show the commit message for the active line.
- Search: Search the repository directly from the IDE.
- Tree: Explore the entire folder structure of a different branch or older sha.
- Visible: Show the visible changes as long as the menu was visible on blame.
FAQ
Is this in beta?
- Someone said
v0.2.21
is a stable release. Subsequent versions were released with
tons of features
requested in e.g. open issues. Those changes are considered experimental so feel
free to open an issue for bugs or new features.
Where is the inline blame?
- Inline blame must be enabled in settings. It's enabled on the far right side
by default. It can be set to be displayed on the left side instead. It's not
shown while word-wrap is enabled.
Why isn't inline blame aligned?
- This should be fixed. If not, there could be a different extension installed
that is causing conflicts. Or it could be another bug to be reported.
How to open commits online with multiple repositories and links?
What about changes processed outside of IDE?
- There is a setting that does or does not start a new process for blame. If on,
changes outside of the IDE should be picked up if the file is in the active
editor when it's changed. Feel free to file a bug if and how you think this
should be more robust.
Is there any documentation? Here are a few resources, starting from the most up
to date on top.
Where is the Git Blame menu?
- It's only available when a file is open. In order to use the sub-menus the
file must reside on disk somewhere. The active file is the seed for many of the
available menus. The git directory of that file will be used for some of the
listings. That's why an active file needs to be available.
Commands
git-blame.commands.commitDiffFile
- Git Blame: Apply Diff File (from base).
- Experimental and can fail silently sometimes for some reason.
git-blame.commands.showDiffFile
- Git Blame: Show Diff File (from base).
- Pre-requisite for commitDiffFile to show the diff from a base.
git-blame.commands.quickPick.log
- Git Blame: Git Log.
- Show the log in chunks, allowing for checkout, copy, and more.
git-blame.commands.quickPick.reflog
- Git Blame: Git Reflog.
- Show the reflog, similar to the related log command.
git-blame.commands.quickPick.branch
- Git Blame: Git Branch.
- Show branches in descending order from the most recent commit.
git-blame.commands.quickPick.help
- Git Blame: Help.
- Possibly out of date documentation.
git-blame.commands.setWordWrapOff
- Git Blame: Set Word Wrap Off For Inline Blame.
- Inline blame works best when word wrap is off.
git-blame.configs.inlineBlame.position
- On which side of the text to show the inline blame. The right side is the
default.
Settings
git-blame.config.inlineBlame.hoverMessage.activeLine
- Show inline blame hover text for the active line over the first and last
characters, but not in between. This makes it easy to see the log without having
to scroll to the right by a variable amount.
git-blame.gitWebUrl:
- The url to open when opening git web online.\n\nExample:
https://example.com/$ID
, where $ID
is the commit id.",
git-blame.showStatusBar
git-blame.config.logClickUrls
- Customizable click urls based the contents of a line.
git-blame.config.showBlameInline
- Show inline blame alongside code
- Word-wrapping must be disabled.
git-blame.config.inlineBlameStartColumn
- What column to start the left aligned inline blame. Default 80.
git-blame.config.inlineBlameHoverMessage
- Show inline blame hover text. Default true.
git-blame.logView.maxCommitCount
- Maximum number of commits in Git Blame Log.
git-blame.fileView.maxCommitCount",
- Maximum number of commits in Git Blame File.
git-blame.branchView.maxCommitCount",
- Maximum number of commits in Git Blame Branch.
Configuration
A .gitblame file can be used anywhere to specify which url to use to open the
commit online. Learn more.