summaryrefslogtreecommitdiffstats
path: root/manual/src/custom-themes.md
diff options
context:
space:
mode:
Diffstat (limited to 'manual/src/custom-themes.md')
-rw-r--r--manual/src/custom-themes.md25
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.