Skip to content

evandroforks/GitGutter

 
 

Repository files navigation

GitGutter

A Sublime Text plug-in to show information about files in a git repository:

  1. Gutter Icons indicating inserted, modified or deleted lines
  2. Diff Popup with details about modified lines
  3. Status Bar Text with information about file and repository

and provides some commands like:

  1. Goto Change to navigate between modified lines
  2. Copy from Commit to copy the original content from the commit
  3. Revert to Commit to revert a modified hunk to the original state in a commit

Installation

By Package Control

  1. Download & Install Sublime Text 3 (https://www.sublimetext.com/3)
  2. Go to the menu Tools -> Install Package Control, then, wait few seconds until the installation finishes up
  3. Now, Go to the menu Preferences -> Package Control
  4. Type Add Channel on the opened quick panel and press Enter
  5. Then, input the following address and press Enter
    https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json
    
  6. Go to the menu Tools -> Command Palette... (Ctrl+Shift+P)
  7. Type Preferences: Package Control Settings – User on the opened quick panel and press Enter
  8. Then, find the following setting on your Package Control.sublime-settings file:
    "channels":
    [
        "https://packagecontrol.io/channel_v3.json",
        "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
    ],
  9. And, change it to the following, i.e., put the https://raw.githubusercontent... line as first:
    "channels":
    [
        "https://raw.githubusercontent.com/evandrocoan/StudioChannel/master/channel.json",
        "https://packagecontrol.io/channel_v3.json",
    ],
    • The https://raw.githubusercontent... line must to be added before the https://packagecontrol.io... one, otherwise, you will not install this forked version of the package, but the original available on the Package Control default channel https://packagecontrol.io...
  10. Now, go to the menu Preferences -> Package Control
  11. Type Install Package on the opened quick panel and press Enter
  12. Then, search for GitGutter and press Enter

See also:

  1. ITE - Integrated Toolset Environment
  2. Package control docs for details.

Gutter Icons & Status Bar Text

screenshot

The icons of the default theme have the following meaning:

Icon Description
inserted inserted line
changed modified line
deleted deleted region borders
ignored ignored file
untracked untracked file

Diff Popup

The diff popup shows the original content from the commit or the differences between it and the working content.

requires Sublime Text 3 Build 3124+ and mdpopups 2.0.0+

diff_popup_screenshot

The toolbar provides some commands to interact with or modify the changes.

symbol meaning of the symbol
× close the popup
goto to first change
goto to previous change
goto to next change
≈, ≉ enable/disable difference highlighting
copy the original content from the commit
revert a modified hunk to the original state in a commit

Documentaion

Please read https://jisaacks.github.io/GitGutter/ for detailed information about