diff options
Diffstat (limited to 'manual/src/custom-themes.md')
-rw-r--r-- | manual/src/custom-themes.md | 25 |
1 files changed, 0 insertions, 25 deletions
diff --git a/manual/src/custom-themes.md b/manual/src/custom-themes.md deleted file mode 100644 index 52a61d8c..00000000 --- a/manual/src/custom-themes.md +++ /dev/null @@ -1,25 +0,0 @@ -# Custom themes - -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 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] - path = /PATH/TO/delta/themes.gitconfig -``` - -Then, add your chosen color theme to your features list, e.g. - -```gitconfig -[delta] - features = collared-trogon - side-by-side = true - ... -``` - -Note that this terminology differs from [bat](https://github.com/sharkdp/bat): bat does not apply background colors, and uses the term "theme" to refer to what delta calls `syntax-theme`. Delta does not have a setting named "theme": a theme is a "feature", so one uses `features` to select a theme. |