Skip to content

Commit 514ac8f

Browse files
committed
doc: document how to use tinted-delta
1 parent b249d7c commit 514ac8f

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

USAGE.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ For more general usage, look at the [Usage section] in [README.md].
1717
- [qutebrowser](#qutebrowser)
1818
- [rofi](#rofi)
1919
- [dunst](#dunst)
20+
- [delta](#delta)
2021

2122
## Shell completions
2223

@@ -502,6 +503,39 @@ However, limited testing has shown `dunst` will not complain if its configuratio
502503
hook = "cat ~/.config/dunst/dunstrc.local %f > ~/.config/dunst/dunstrc && systemctl --user restart dunst"
503504
```
504505

506+
## Delta
507+
508+
Add the following to `~/.config/tinted-theming/tinty/config.toml`:
509+
510+
```toml
511+
[[items]]
512+
path = "https://github.com/tinted-theming/tinted-delta"
513+
name = "delta"
514+
themes-dir = "configs"
515+
hook = "cp -f %f ~/.config/tinted-theming/delta.gitconfig"
516+
supported-systems = ["base16", "base24"]
517+
```
518+
519+
Configure [delta] as your Git pager and/or difftool under the name `delta`, like this:
520+
521+
```gitconfig
522+
[core]
523+
pager = delta
524+
525+
[interactive]
526+
diffFilter = delta --color-only
527+
528+
# Delta configuration not related to theming:
529+
[delta]
530+
navigate = true
531+
line-numbers = true
532+
hyperlinks = true
533+
tabs = 4
534+
535+
# Include the config file generated by the tinty hook, which contains theme-related configuration:
536+
[include]
537+
path = ~/.config/tinted-theming/delta.gitconfig
538+
```
505539
[Usage section]: https://github.com/tinted-theming/tinty?tab=readme-ov-file#usage
506540
[README.md]: https://github.com/tinted-theming/tinty/blob/main/README.md
507541
[bat]: https://github.com/sharkdp/bat
@@ -515,3 +549,4 @@ hook = "cat ~/.config/dunst/dunstrc.local %f > ~/.config/dunst/dunstrc && system
515549
[README CLI section]: README.md#cli
516550
[contrib/completion]: contrib/completion
517551
[base16-qutebrowser]: https://github.com/tinted-theming/base16-qutebrowser
552+
[delta]: https://github.com/dandavison/delta

0 commit comments

Comments
 (0)