on master help sign in
Rework beginning of themes chapter
1af8dd9CJ van den Berg
book/src/themes.md+5−5
@@ -1,14 +1,14 @@
1# Themes
1# Themes
2
2
3−First you'll need to place selected themes in your `themes` directory (i.e `~/.config/helix/themes`), the directory might have to be created beforehand.
3+To use a theme add `theme = "<name>"` to your [`config.toml`](./configuration.md) at the very top of the file before the first section or select it during runtime using `:theme <name>`.
4
4
5−To use a custom theme add `theme = <name>` to your [`config.toml`](./configuration.md) or override it during runtime using `:theme <name>`.
5+## Creating a theme
6
6
7−The default theme.toml can be found [here](https://github.com/helix-editor/helix/blob/master/theme.toml), and user submitted themes [here](https://github.com/helix-editor/helix/blob/master/runtime/themes).
7+Create a file with the name of your theme as file name (i.e `mytheme.toml`) and place it in your `themes` directory (i.e `~/.config/helix/themes`). The directory might have to be created beforehand.
8
8
9−## Creating a theme
9+The names "default" and "base16_default" are reserved for the builtin themes and cannot be overridden by user defined themes.
10
10
11−First create a file with the name of your theme as file name (i.e `mytheme.toml`) and place it in your `themes` directory (i.e `~/.config/helix/themes`).
11+The default theme.toml can be found [here](https://github.com/helix-editor/helix/blob/master/theme.toml), and user submitted themes [here](https://github.com/helix-editor/helix/blob/master/runtime/themes).
12
12
13Each line in the theme file is specified as below:
13Each line in the theme file is specified as below:
14
14