diff --git a/404.html b/404.html index 1dc6b1877..f029d51d7 100644 --- a/404.html +++ b/404.html @@ -85,7 +85,7 @@ diff --git a/configuration.html b/configuration.html index 6805c4a6a..1d480387a 100644 --- a/configuration.html +++ b/configuration.html @@ -84,7 +84,7 @@ @@ -146,80 +146,11 @@

Configuration

+

To override global configuration parameters create a config.toml file located in your config directory (i.e ~/.config/helix/config.toml).

LSP

To disable language server progress report from being displayed in the status bar add this option to your config.toml:

lsp-progress = false
-

Theme

-

Use a custom theme by placing a theme.toml in your config directory (i.e ~/.config/helix/theme.toml). The default theme.toml can be found here, and user submitted themes here.

-

Styles in theme.toml are specified of in the form:

-
key = { fg = "#ffffff", bg = "#000000", modifiers = ["bold", "italic"] }
-
-

where name represents what you want to style, fg specifies the foreground color, bg the background color, and modifiers is a list of style modifiers. bg and modifiers can be omitted to defer to the defaults.

-

To specify only the foreground color:

-
key = "#ffffff"
-
-

if the key contains a dot '.', it must be quoted to prevent it being parsed as a dotted key.

-
"key.key" = "#ffffff"
-
-

Possible modifiers:

- - - - - - - - - - -
Modifier
bold
dim
italic
underlined
slow_blink
rapid_blink
reversed
hidden
crossed_out
-

Possible keys:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
KeyNotes
attribute
keyword
keyword.directivePreprocessor directives (#if in C)
namespace
punctuation
punctuation.delimiter
operator
special
property
variable
variable.parameter
type
type.builtin
constructor
function
function.macro
function.builtin
comment
variable.builtin
constant
constant.builtin
string
number
escapeEscaped characters
labelFor lifetimes
module
ui.background
ui.linenr
ui.linenr.selectedFor lines with cursors
ui.statusline
ui.popup
ui.window
ui.help
ui.text
ui.text.focus
ui.menu.selected
ui.selectionFor selections in the editing area
warningLSP warning
errorLSP error
infoLSP info
hintLSP hint
-

These keys match tree-sitter scopes. We half-follow the common scopes from macromates language grammars with some differences.

-

For a given highlight produced, styling will be determined based on the longest matching theme key. So it's enough to provide function to highlight function.macro and function.builtin as well, but you can use more specific scopes to highlight specific cases differently.

@@ -229,7 +160,7 @@ - @@ -243,7 +174,7 @@ - diff --git a/hooks.html b/hooks.html index 0a3e12722..7d07cbe42 100644 --- a/hooks.html +++ b/hooks.html @@ -84,7 +84,7 @@
diff --git a/index.html b/index.html index 57e8765e8..a2535c7b1 100644 --- a/index.html +++ b/index.html @@ -84,7 +84,7 @@ diff --git a/install.html b/install.html index c4d480bee..bc0edf69a 100644 --- a/install.html +++ b/install.html @@ -84,7 +84,7 @@ diff --git a/keymap.html b/keymap.html index 869673140..f10cc6808 100644 --- a/keymap.html +++ b/keymap.html @@ -84,7 +84,7 @@ @@ -312,7 +312,7 @@ the selection.