diff options
author | Dan Davison <dandavison7@gmail.com> | 2023-08-01 08:02:42 -0400 |
---|---|---|
committer | Dan Davison <dandavison7@gmail.com> | 2023-08-01 08:02:42 -0400 |
commit | b0aed26ed762b1d0a21179263b5cc5bc4f1f25a3 (patch) | |
tree | 0ef17e4d9d8cf3e23a846718c59b587e70e8bd93 | |
parent | 0608765f40a193d16651e1ac0c547bd2f9280bf9 (diff) |
Add documentation for browsing themes.
-rw-r--r-- | manual/src/custom-themes.md | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/manual/src/custom-themes.md b/manual/src/custom-themes.md index 2f37aef8..52a61d8c 100644 --- a/manual/src/custom-themes.md +++ b/manual/src/custom-themes.md @@ -2,7 +2,11 @@ A "theme" in delta is just a collection of settings grouped together in a named [feature](./features-named-groups-of-settings.md). One of the available settings is `syntax-theme`: this dictates the colors and styles that are applied to foreground text by the syntax highlighter. Thus the concept of "theme" in delta encompasses not just the foreground syntax-highlighting color theme, but also background colors, decorations such as boxes and under/overlines, etc. -The delta git repo contains a [collection of themes](https://github.com/dandavison/delta/blob/master/themes.gitconfig) created by users. These focus on the visual appearance: colors etc. If you want features like `side-by-side` or `navigate`, you would set that yourself, after selecting the color theme. To use the delta themes, clone the delta repo (or [download](https://raw.githubusercontent.com/dandavison/delta/master/themes.gitconfig) the raw `themes.gitconfig` file) and add the following entry in your gitconfig: +The delta git repo contains a [collection of themes](https://github.com/dandavison/delta/blob/master/themes.gitconfig) created by users. These focus on the visual appearance: colors etc. If you want features like `side-by-side` or `navigate`, you would set that yourself, after selecting the color theme. + +To browse themes, use `delta --show-themes`, or browse the list of theme PRs: https://github.com/dandavison/delta/commits/master/themes.gitconfig. (The PRs nearly always have screenshots in them.) + +To use the delta themes, clone the delta repo (or [download](https://raw.githubusercontent.com/dandavison/delta/master/themes.gitconfig) the raw `themes.gitconfig` file) and add the following entry in your gitconfig: ```gitconfig [include] |