3 homepage: https://github.com/dandavison/delta
5 delta: A syntax-highlighting pager for git and diff output
8 To update or switch versions, run `webi delta` (or `@0.9.1`, `@0.9.0`, etc).
12 > `delta` gives you GitHub-style diffs, with word-level diff coloring, right in
13 > your trusty rusty terminal.
15 ![](https://user-images.githubusercontent.com/52205/65248525-32250480-daea-11e9-9965-1a05c6a4bdf4.png)
19 - **The install**: which files are added or changed
20 - **Configuration**: how to set a syntax theme
21 - **Preview**: how to list or show the color schemes
22 - **Manual Config**: how to turn `delta` on or off for git diffs
24 For the full set of options, be sure to check out the helpful
25 [README](https://github.com/dandavison/delta).
29 These are the files that are created and/or modified with this installer:
32 ~/.config/envman/PATH.env
35 ~/.local/opt/delta-VERSION/bin/delta
38 ## How to set delta's color scheme
40 Delta uses `~/.gitconfig` for most of its options.
42 Set `delta.syntax-theme` to change the color scheme:
45 git config delta.syntax-theme 'Coldark-Dark'
48 ## How to list / preview delta's themes
50 You can list all available themes with `--list-syntax-themes`, or see each color
51 schemes in action with `--show-syntax-themes`:
54 delta --list-syntax-themes --dark
55 delta --show-syntax-themes --dark
58 You can also show only light or dark themes:
61 delta --list-syntax-themes --light
62 delta --show-syntax-themes --light
66 delta --list-syntax-themes --dark
67 delta --show-syntax-themes --dark
70 Here's the current list, for convenience:
72 ### Dark Syntax Themes
81 Monokai Extended Bright
82 Monokai Extended Origin
96 ### Light Syntax Themes
100 Monokai Extended Light
106 ## How to manually configure git to use delta
108 You can use `git config --global` to get or set any arbitrary option of
112 git config --global page.diff delta
113 git config --global page.show delta
114 git config --global page.log delta
115 git config --global page.blame delta
116 git config --global page.reflog delta
118 git config --global interactive.diffFilter 'delta --color-only'
120 git config delta.syntax-theme 'Coldark-Dark'
123 Your `~/.gitconfig` will then contain these sections and options:
134 diffFilter = delta --color-only
137 syntax-theme = Coldark-Dark