Unnamed repository; edit this file 'description' to name the repository.
Diffstat (limited to 'book/src/themes.md')
| -rw-r--r-- | book/src/themes.md | 34 |
1 files changed, 4 insertions, 30 deletions
diff --git a/book/src/themes.md b/book/src/themes.md index 353a4684..40e12330 100644 --- a/book/src/themes.md +++ b/book/src/themes.md @@ -2,17 +2,6 @@ To use a theme add `theme = "<name>"` to the top of your [`config.toml`](./configuration.md) file, or select it during runtime using `:theme <name>`. -Separate themes can be configured for light and dark modes. On terminals supporting [mode 2031 dark/light detection](https://github.com/contour-terminal/contour/blob/master/docs/vt-extensions/color-palette-update-notifications.md), the theme mode is detected from the terminal. - -```toml -[theme] -dark = "catppuccin_frappe" -light = "catppuccin_latte" -## Optional. Used if the terminal doesn't declare a preference. -## Defaults to the theme set for `dark` if not specified. -# fallback = "catppuccin_frappe" -``` - ## Creating a theme Create a file with the name of your theme as the file name (i.e `mytheme.toml`) and place it in your `themes` directory (i.e `~/.config/helix/themes` or `%AppData%\helix\themes` on Windows). The directory might have to be created beforehand. @@ -141,24 +130,13 @@ inherits = "boo_berry" berry = "#2A2A4D" ``` -### Rainbow - -The `rainbow` key is used for rainbow highlight for matching brackets. -The key is a list of styles. - -```toml -rainbow = ["#ff0000", "#ffa500", "#fff000", { fg = "#00ff00", modifiers = ["bold"] }] -``` - -Colors from the palette and modifiers may be used. - ### Scopes The following is a list of scopes available to use for styling: #### Syntax highlighting -These keys match [tree-sitter scopes](https://tree-sitter.github.io/tree-sitter/3-syntax-highlighting.html#highlights). +These keys match [tree-sitter scopes](https://tree-sitter.github.io/tree-sitter/syntax-highlighting#theme). When determining styling for a highlight, the longest matching theme key will be used. For example, if the highlight is `function.builtin.static`, the key `function.builtin` will be used instead of `function`. @@ -193,10 +171,8 @@ We use a similar set of scopes as - `comment` - Code comments - `line` - Single line comments (`//`) - - `documentation` - Line documentation comments (e.g. `///` in Rust) - `block` - Block comments (e.g. (`/* */`) - - `documentation` - Block documentation comments (e.g. `/** */` in Rust) - - `unused` - Unused variables and patterns, e.g. `_` and `_foo` + - `documentation` - Documentation comments (e.g. `///` in Rust) - `variable` - Variables - `builtin` - Reserved language variables (`self`, `this`, `super`, etc.) @@ -205,7 +181,7 @@ We use a similar set of scopes as - `member` - Fields of composite data types (e.g. structs, unions) - `private` - Private fields that use a unique syntax (currently just ECMAScript-based languages) -- `label` - `.class`, `#id` in CSS, etc. +- `label` - `punctuation` - `delimiter` - Commas, colons @@ -240,7 +216,7 @@ We use a similar set of scopes as - `namespace` -- `special` - `derive` in Rust, etc. +- `special` - `markup` - `heading` @@ -329,7 +305,6 @@ These scopes are used for theming the editor interface: | `ui.text.focus` | The currently selected line in the picker | | `ui.text.inactive` | Same as `ui.text` but when the text is inactive (e.g. suggestions) | | `ui.text.info` | The key: command text in `ui.popup.info` boxes | -| `ui.text.directory` | Directory names in prompt completion | | `ui.virtual.ruler` | Ruler columns (see the [`editor.rulers` config][editor-section]) | | `ui.virtual.whitespace` | Visible whitespace characters | | `ui.virtual.indent-guide` | Vertical indent width guides | @@ -360,6 +335,5 @@ These scopes are used for theming the editor interface: | `diagnostic.error` | Diagnostics error (editing area) | | `diagnostic.unnecessary` | Diagnostics with unnecessary tag (editing area) | | `diagnostic.deprecated` | Diagnostics with deprecated tag (editing area) | -| `tabstop` | Snippet placeholder | [editor-section]: ./configuration.md#editor-section |