2019-07-14 23:33:25 +03:00
[![Build Status ](https://travis-ci.com/dandavison/delta.svg?branch=master )](https://travis-ci.com/dandavison/delta)
2019-06-26 19:07:23 +03:00
## Δ
2019-07-16 05:36:20 +03:00
A syntax-highlighting pager for git.
2019-06-26 19:07:23 +03:00
2019-07-01 07:28:18 +03:00
< table >
< tr >
< td >
2019-07-01 07:35:43 +03:00
< img width = 518px style = "border: 1px solid black"
src="https://user-images.githubusercontent.com/52205/60410484-8cbb5e00-9b96-11e9-9d56-bb84ac0bce82.png"
2019-07-01 07:28:18 +03:00
alt="image" />
< / td >
< td >
2019-07-01 07:35:43 +03:00
< img width = 500px style = "border: 1px solid black"
src="https://user-images.githubusercontent.com/52205/60282969-230d2c80-98d6-11e9-8656-09073c8a0985.png"
2019-07-01 07:28:18 +03:00
alt="image" />
< / td >
< / tr >
2019-07-01 11:22:11 +03:00
< tr >
< td >
delta --dark (default)
< / td >
< td >
delta --light --width=variable --highlight-removed
< / td >
< / tr >
2019-07-01 07:28:18 +03:00
< / table >
2019-07-16 05:36:20 +03:00
## Installation
2019-06-27 19:28:28 +03:00
2019-07-16 05:36:20 +03:00
```sh
brew tap dandavison/delta https://github.com/dandavison/delta
brew install dandavison/delta/git-delta
```
Alternatively, executables for your platform can be downloaded at https://github.com/dandavison/delta/releases.
## Configure git to use delta
```sh
git config --global core.pager delta # --light for light terminal backgrounds
```
Alternatively, you can edit your `.gitconfig` directly. An example is
```
[core]
pager = delta --plus-color="#012800" --minus-color="#340001" --theme="base16-ocean.dark"
2019-06-27 18:17:14 +03:00
```
2019-07-16 05:36:20 +03:00
All git commands that display diff output should now display syntax-highlighted output. For example:
- `git diff`
- `git show`
- `git log -p`
- `git stash show -p`
## Usage
```
2019-06-27 18:17:14 +03:00
USAGE:
delta [FLAGS] [OPTIONS]
FLAGS:
2019-07-01 07:00:55 +03:00
--compare-themes Compare available syntax highlighting themes. To use this option, supply git diff output
to delta on standard input. For example: `git show --color=always | delta --compare-
themes`.
--dark Use colors appropriate for a dark terminal background. For more control, see --theme,
--plus-color, and --minus-color.
-h, --help Prints help information
--highlight-removed Apply syntax highlighting to removed lines. The default is to apply syntax highlighting
to unchanged and new lines only.
--light Use colors appropriate for a light terminal background. For more control, see --theme,
--plus-color, and --minus-color.
--list-languages List supported languages and associated file extensions.
--list-themes List available syntax highlighting themes.
-V, --version Prints version information
2019-06-27 18:17:14 +03:00
OPTIONS:
2019-07-16 05:36:20 +03:00
--commit-style < commit_style >
Formatting style for commit section of git output. Options are: plain, box. [default: plain]
2019-06-27 18:17:14 +03:00
2019-07-16 05:36:20 +03:00
--file-style < file_style >
Formatting style for file section of git output. Options are: plain, box, underline. [default: underline]
2019-06-26 19:07:23 +03:00
2019-07-16 05:36:20 +03:00
--hunk-style < hunk_style >
Formatting style for hunk section of git output. Options are: plain, box. [default: box]
2019-06-27 22:50:54 +03:00
2019-07-16 05:36:20 +03:00
--minus-color < minus_color > The background color (RGB hex) to use for removed lines.
--minus-emph-color < minus_emph_color >
The background color (RGB hex) to use for emphasized sections of removed lines.
--plus-color < plus_color > The background color (RGB hex) to use for added lines.
--plus-emph-color < plus_emph_color >
The background color (RGB hex) to use for emphasized sections of added lines.
--theme < theme > The syntax highlighting theme to use.
-w, --width < width >
The width (in characters) of the background color highlighting. By default, the width is the current
terminal width. Use --width=variable to apply background colors to the end of each line, without right
padding to equal width.
```
2019-06-26 19:07:23 +03:00
2019-06-27 18:23:11 +03:00
## 24 bit color
delta works best if your terminal application supports 24 bit colors. See https://gist.github.com/XVilka/8346728. For example, on macos, iTerm2 works but Terminal.app does not.
If you're using tmux, it's worth checking that 24 bit color is working correctly. For example, run a color test script like [this one ](https://gist.githubusercontent.com/lifepillar/09a44b8cf0f9397465614e622979107f/raw/24-bit-color.sh ), or the others listed at https://gist.github.com/XVilka/8346728. If you do not see smooth color gradients, see the discussion at [tmux#696 ](https://github.com/tmux/tmux/issues/696 ). The short version is you need something like this in your `~/.tmux.conf` :
```
set -ga terminal-overrides ",xterm-256color:Tc"
```
and you may then need to quit tmux completely for it to take effect.
2019-06-26 21:57:58 +03:00
2019-06-26 19:07:23 +03:00
## Credit
https://github.com/trishume/syntect< br >
2019-07-10 18:05:57 +03:00
https://github.com/sharkdp/bat< br >
https://github.com/so-fancy/diff-so-fancy