From b0aed26ed762b1d0a21179263b5cc5bc4f1f25a3 Mon Sep 17 00:00:00 2001 From: Dan Davison Date: Tue, 1 Aug 2023 08:02:42 -0400 Subject: Add documentation for browsing themes. --- manual/src/custom-themes.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) 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] -- cgit v1.2.3