Skip to content

Commit

Permalink
doc: document how to use tinted-delta (#87)
Browse files Browse the repository at this point in the history
  • Loading branch information
bezhermoso authored Dec 25, 2024
1 parent b249d7c commit dabd2c3
Showing 1 changed file with 34 additions and 0 deletions.
34 changes: 34 additions & 0 deletions USAGE.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ For more general usage, look at the [Usage section] in [README.md].
- [qutebrowser](#qutebrowser)
- [rofi](#rofi)
- [dunst](#dunst)
- [delta](#delta)

## Shell completions

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

## Delta

Add the following to `~/.config/tinted-theming/tinty/config.toml`:

```toml
[[items]]
path = "https://github.com/tinted-theming/tinted-delta"
name = "tinted-delta"
themes-dir = "configs"
supported-systems = ["base16", "base24"]
```

Configure [delta] as your Git pager and/or difftool under the name `delta`, like this:

```gitconfig
[core]
pager = delta

[interactive]
diffFilter = delta --color-only

# Delta configuration not related to theming:
[delta]
navigate = true
line-numbers = true
hyperlinks = true
tabs = 4

# Include the config file generated by the tinty hook, which contains theme-related configuration:
[include]
path = ~/.local/share/tinted-theming/tinty/tinted-delta-configs-file.gitconfig
```
[Usage section]: https://github.com/tinted-theming/tinty?tab=readme-ov-file#usage
[README.md]: https://github.com/tinted-theming/tinty/blob/main/README.md
[bat]: https://github.com/sharkdp/bat
Expand All @@ -515,3 +548,4 @@ hook = "cat ~/.config/dunst/dunstrc.local %f > ~/.config/dunst/dunstrc && system
[README CLI section]: README.md#cli
[contrib/completion]: contrib/completion
[base16-qutebrowser]: https://github.com/tinted-theming/base16-qutebrowser
[delta]: https://github.com/dandavison/delta

0 comments on commit dabd2c3

Please sign in to comment.