Compare commits

...

9 Commits

Author SHA1 Message Date
the-mikedavis
755a3a771b deploy: 55167c21df 2025-09-22 13:32:38 +00:00
the-mikedavis
159827f691 deploy: 8acfc55280 2025-09-21 18:56:53 +00:00
the-mikedavis
2fcc6fd85b deploy: 1bf9879778 2025-09-21 16:17:04 +00:00
the-mikedavis
8f5d98224d deploy: 23a647aee8 2025-09-21 15:41:16 +00:00
the-mikedavis
f15d6c28f2 deploy: 0ae37dc52b 2025-09-18 14:12:45 +00:00
the-mikedavis
ebdd1cf55d deploy: d015eff4aa 2025-09-15 15:19:01 +00:00
the-mikedavis
8e34a9a4a9 deploy: 2dddace12e 2025-09-15 13:37:23 +00:00
the-mikedavis
9fc1cfeeaa deploy: 1388166570 2025-09-14 00:02:12 +00:00
the-mikedavis
b3e891ba6c deploy: 92b0a2f414 2025-09-12 14:32:32 +00:00
6 changed files with 58 additions and 8 deletions

View File

@@ -224,9 +224,10 @@
<tr><td><code>indent-heuristic</code></td><td>How the indentation for a newly inserted line is computed: <code>simple</code> just copies the indentation level from the previous line, <code>tree-sitter</code> computes the indentation based on the syntax tree and <code>hybrid</code> combines both approaches. If the chosen heuristic is not available, a different one will be used as a fallback (the fallback order being <code>hybrid</code> -&gt; <code>tree-sitter</code> -&gt; <code>simple</code>).</td><td><code>hybrid</code></td></tr>
<tr><td><code>jump-label-alphabet</code></td><td>The characters that are used to generate two character jump labels. Characters at the start of the alphabet are used first.</td><td><code>"abcdefghijklmnopqrstuvwxyz"</code></td></tr>
<tr><td><code>end-of-line-diagnostics</code></td><td>Minimum severity of diagnostics to render at the end of the line. Set to <code>disable</code> to disable entirely. Refer to the setting about <code>inline-diagnostics</code> for more details</td><td><code>"hint"</code></td></tr>
<tr><td><code>clipboard-provider</code></td><td>Which API to use for clipboard interaction. One of <code>pasteboard</code> (MacOS), <code>wayland</code>, <code>x-clip</code>, <code>x-sel</code>, <code>win-32-yank</code>, <code>termux</code>, <code>tmux</code>, <code>windows</code>, <code>termcode</code>, <code>none</code>, or a custom command set.</td><td>Platform and environment specific.</td></tr>
<tr><td><code>clipboard-provider</code></td><td>Which API to use for clipboard interaction. One of <code>pasteboard</code> (MacOS), <code>wayland</code>, <code>x-clip</code>, <code>x-sel</code>, <code>win32-yank</code>, <code>termux</code>, <code>tmux</code>, <code>windows</code>, <code>termcode</code>, <code>none</code>, or a custom command set.</td><td>Platform and environment specific.</td></tr>
<tr><td><code>editor-config</code></td><td>Whether to read settings from <a href="https://editorconfig.org">EditorConfig</a> files</td><td><code>true</code></td></tr>
<tr><td><code>rainbow-brackets</code></td><td>Whether to render rainbow colors for matching brackets. Requires tree-sitter <code>rainbows.scm</code> queries for the language.</td><td><code>false</code></td></tr>
<tr><td><code>kitty-keyboard-protocol</code></td><td>Whether to enable Kitty Keyboard Protocol. Can be <code>enabled</code>, <code>disabled</code> or <code>auto</code></td><td><code>auto</code></td></tr>
</tbody></table>
</div>
<h3 id="editorclipboard-provider-section"><a class="header" href="#editorclipboard-provider-section"><code>[editor.clipboard-provider]</code> Section</a></h3>
@@ -361,6 +362,20 @@ not visible in the Helix file picker and global search.</p>
!.gitignore
!.gitattributes
</code></pre>
<h3 id="editorfile-explorer-section"><a class="header" href="#editorfile-explorer-section"><code>[editor.file-explorer]</code> Section</a></h3>
<p>In addition to the options for the file picker and global search, a similar set of options is presented to configure the file explorer separately. However, unlike the file picker, the defaults are set to avoid ignoring most files.</p>
<p>Note that the ignore files consulted by the file explorer when <code>ignore</code> is set to true are the same ones used by the file picker, including the aforementioned Helix-specific ignore files.</p>
<div class="table-wrapper"><table><thead><tr><th>Key</th><th>Description</th><th>Default</th></tr></thead><tbody>
<tr><td><code>hidden</code></td><td>Enables ignoring hidden files</td><td><code>false</code></td></tr>
<tr><td><code>follow-symlinks</code></td><td>Follow symlinks instead of ignoring them</td><td><code>false</code></td></tr>
<tr><td><code>parents</code></td><td>Enables reading ignore files from parent directories</td><td><code>false</code></td></tr>
<tr><td><code>ignore</code></td><td>Enables reading <code>.ignore</code> files</td><td><code>false</code></td></tr>
<tr><td><code>git-ignore</code></td><td>Enables reading <code>.gitignore</code> files</td><td><code>false</code></td></tr>
<tr><td><code>git-global</code></td><td>Enables reading global <code>.gitignore</code>, whose path is specified in git's config: <code>core.excludesfile</code> option</td><td><code>false</code></td></tr>
<tr><td><code>git-exclude</code></td><td>Enables reading <code>.git/info/exclude</code> files</td><td><code>false</code></td></tr>
<tr><td><code>flatten-dirs</code></td><td>Enables flattening single child directories</td><td><code>true</code></td></tr>
</tbody></table>
</div>
<h3 id="editorauto-pairs-section"><a class="header" href="#editorauto-pairs-section"><code>[editor.auto-pairs]</code> Section</a></h3>
<p>Enables automatic insertion of pairs to parentheses, brackets, etc. Can be a
simple boolean value, or a specific mapping of pairs of single characters.</p>

View File

@@ -312,7 +312,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>kdl</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>koka</td><td></td><td></td><td></td><td></td><td></td><td><code>koka</code></td></tr>
<tr><td>kotlin</td><td></td><td></td><td></td><td></td><td></td><td><code>kotlin-language-server</code></td></tr>
<tr><td>koto</td><td></td><td></td><td></td><td></td><td></td><td><code>koto-ls</code></td></tr>
<tr><td>koto</td><td></td><td></td><td></td><td></td><td></td><td><code>koto-ls</code></td></tr>
<tr><td>latex</td><td></td><td></td><td></td><td></td><td></td><td><code>texlab</code></td></tr>
<tr><td>ld</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>ldif</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
@@ -345,7 +345,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>nickel</td><td></td><td></td><td></td><td></td><td></td><td><code>nls</code></td></tr>
<tr><td>nim</td><td></td><td></td><td></td><td></td><td></td><td><code>nimlangserver</code></td></tr>
<tr><td>nix</td><td></td><td></td><td></td><td></td><td></td><td><code>nil</code>, <code>nixd</code></td></tr>
<tr><td>nu</td><td></td><td></td><td></td><td></td><td></td><td><code>nu</code></td></tr>
<tr><td>nu</td><td></td><td></td><td></td><td></td><td></td><td><code>nu</code></td></tr>
<tr><td>nunjucks</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>ocaml</td><td></td><td></td><td></td><td></td><td></td><td><code>ocamllsp</code></td></tr>
<tr><td>ocaml-interface</td><td></td><td></td><td></td><td></td><td></td><td><code>ocamllsp</code></td></tr>
@@ -400,6 +400,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>shellcheckrc</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>slang</td><td></td><td></td><td></td><td></td><td></td><td><code>slangd</code></td></tr>
<tr><td>slint</td><td></td><td></td><td></td><td></td><td></td><td><code>slint-lsp</code></td></tr>
<tr><td>slisp</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>smali</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>smithy</td><td></td><td></td><td></td><td></td><td></td><td><code>cs</code></td></tr>
<tr><td>sml</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
@@ -456,6 +457,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>werk</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wesl</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wgsl</td><td></td><td></td><td></td><td></td><td></td><td><code>wgsl-analyzer</code></td></tr>
<tr><td>wikitext</td><td></td><td></td><td></td><td></td><td></td><td><code>wikitext-lsp</code></td></tr>
<tr><td>wit</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wren</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>xit</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>

View File

@@ -1802,7 +1802,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>kdl</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>koka</td><td></td><td></td><td></td><td></td><td></td><td><code>koka</code></td></tr>
<tr><td>kotlin</td><td></td><td></td><td></td><td></td><td></td><td><code>kotlin-language-server</code></td></tr>
<tr><td>koto</td><td></td><td></td><td></td><td></td><td></td><td><code>koto-ls</code></td></tr>
<tr><td>koto</td><td></td><td></td><td></td><td></td><td></td><td><code>koto-ls</code></td></tr>
<tr><td>latex</td><td></td><td></td><td></td><td></td><td></td><td><code>texlab</code></td></tr>
<tr><td>ld</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>ldif</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
@@ -1835,7 +1835,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>nickel</td><td></td><td></td><td></td><td></td><td></td><td><code>nls</code></td></tr>
<tr><td>nim</td><td></td><td></td><td></td><td></td><td></td><td><code>nimlangserver</code></td></tr>
<tr><td>nix</td><td></td><td></td><td></td><td></td><td></td><td><code>nil</code>, <code>nixd</code></td></tr>
<tr><td>nu</td><td></td><td></td><td></td><td></td><td></td><td><code>nu</code></td></tr>
<tr><td>nu</td><td></td><td></td><td></td><td></td><td></td><td><code>nu</code></td></tr>
<tr><td>nunjucks</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>ocaml</td><td></td><td></td><td></td><td></td><td></td><td><code>ocamllsp</code></td></tr>
<tr><td>ocaml-interface</td><td></td><td></td><td></td><td></td><td></td><td><code>ocamllsp</code></td></tr>
@@ -1890,6 +1890,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>shellcheckrc</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>slang</td><td></td><td></td><td></td><td></td><td></td><td><code>slangd</code></td></tr>
<tr><td>slint</td><td></td><td></td><td></td><td></td><td></td><td><code>slint-lsp</code></td></tr>
<tr><td>slisp</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>smali</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>smithy</td><td></td><td></td><td></td><td></td><td></td><td><code>cs</code></td></tr>
<tr><td>sml</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
@@ -1946,6 +1947,7 @@ Languages</a> guide for more language configuration information.</p>
<tr><td>werk</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wesl</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wgsl</td><td></td><td></td><td></td><td></td><td></td><td><code>wgsl-analyzer</code></td></tr>
<tr><td>wikitext</td><td></td><td></td><td></td><td></td><td></td><td><code>wikitext-lsp</code></td></tr>
<tr><td>wit</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>wren</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
<tr><td>xit</td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
@@ -2091,9 +2093,10 @@ Its settings will be merged with the configuration directory <code>config.toml</
<tr><td><code>indent-heuristic</code></td><td>How the indentation for a newly inserted line is computed: <code>simple</code> just copies the indentation level from the previous line, <code>tree-sitter</code> computes the indentation based on the syntax tree and <code>hybrid</code> combines both approaches. If the chosen heuristic is not available, a different one will be used as a fallback (the fallback order being <code>hybrid</code> -&gt; <code>tree-sitter</code> -&gt; <code>simple</code>).</td><td><code>hybrid</code></td></tr>
<tr><td><code>jump-label-alphabet</code></td><td>The characters that are used to generate two character jump labels. Characters at the start of the alphabet are used first.</td><td><code>"abcdefghijklmnopqrstuvwxyz"</code></td></tr>
<tr><td><code>end-of-line-diagnostics</code></td><td>Minimum severity of diagnostics to render at the end of the line. Set to <code>disable</code> to disable entirely. Refer to the setting about <code>inline-diagnostics</code> for more details</td><td><code>"hint"</code></td></tr>
<tr><td><code>clipboard-provider</code></td><td>Which API to use for clipboard interaction. One of <code>pasteboard</code> (MacOS), <code>wayland</code>, <code>x-clip</code>, <code>x-sel</code>, <code>win-32-yank</code>, <code>termux</code>, <code>tmux</code>, <code>windows</code>, <code>termcode</code>, <code>none</code>, or a custom command set.</td><td>Platform and environment specific.</td></tr>
<tr><td><code>clipboard-provider</code></td><td>Which API to use for clipboard interaction. One of <code>pasteboard</code> (MacOS), <code>wayland</code>, <code>x-clip</code>, <code>x-sel</code>, <code>win32-yank</code>, <code>termux</code>, <code>tmux</code>, <code>windows</code>, <code>termcode</code>, <code>none</code>, or a custom command set.</td><td>Platform and environment specific.</td></tr>
<tr><td><code>editor-config</code></td><td>Whether to read settings from <a href="https://editorconfig.org">EditorConfig</a> files</td><td><code>true</code></td></tr>
<tr><td><code>rainbow-brackets</code></td><td>Whether to render rainbow colors for matching brackets. Requires tree-sitter <code>rainbows.scm</code> queries for the language.</td><td><code>false</code></td></tr>
<tr><td><code>kitty-keyboard-protocol</code></td><td>Whether to enable Kitty Keyboard Protocol. Can be <code>enabled</code>, <code>disabled</code> or <code>auto</code></td><td><code>auto</code></td></tr>
</tbody></table>
</div>
<h3 id="editorclipboard-provider-section"><a class="header" href="#editorclipboard-provider-section"><code>[editor.clipboard-provider]</code> Section</a></h3>
@@ -2228,6 +2231,20 @@ not visible in the Helix file picker and global search.</p>
!.gitignore
!.gitattributes
</code></pre>
<h3 id="editorfile-explorer-section"><a class="header" href="#editorfile-explorer-section"><code>[editor.file-explorer]</code> Section</a></h3>
<p>In addition to the options for the file picker and global search, a similar set of options is presented to configure the file explorer separately. However, unlike the file picker, the defaults are set to avoid ignoring most files.</p>
<p>Note that the ignore files consulted by the file explorer when <code>ignore</code> is set to true are the same ones used by the file picker, including the aforementioned Helix-specific ignore files.</p>
<div class="table-wrapper"><table><thead><tr><th>Key</th><th>Description</th><th>Default</th></tr></thead><tbody>
<tr><td><code>hidden</code></td><td>Enables ignoring hidden files</td><td><code>false</code></td></tr>
<tr><td><code>follow-symlinks</code></td><td>Follow symlinks instead of ignoring them</td><td><code>false</code></td></tr>
<tr><td><code>parents</code></td><td>Enables reading ignore files from parent directories</td><td><code>false</code></td></tr>
<tr><td><code>ignore</code></td><td>Enables reading <code>.ignore</code> files</td><td><code>false</code></td></tr>
<tr><td><code>git-ignore</code></td><td>Enables reading <code>.gitignore</code> files</td><td><code>false</code></td></tr>
<tr><td><code>git-global</code></td><td>Enables reading global <code>.gitignore</code>, whose path is specified in git's config: <code>core.excludesfile</code> option</td><td><code>false</code></td></tr>
<tr><td><code>git-exclude</code></td><td>Enables reading <code>.git/info/exclude</code> files</td><td><code>false</code></td></tr>
<tr><td><code>flatten-dirs</code></td><td>Enables flattening single child directories</td><td><code>true</code></td></tr>
</tbody></table>
</div>
<h3 id="editorauto-pairs-section"><a class="header" href="#editorauto-pairs-section"><code>[editor.auto-pairs]</code> Section</a></h3>
<p>Enables automatic insertion of pairs to parentheses, brackets, etc. Can be a
simple boolean value, or a specific mapping of pairs of single characters.</p>
@@ -2425,6 +2442,14 @@ trigger-length = 4
</code></pre>
<div style="break-before: page; page-break-before: always;"></div><h2 id="themes"><a class="header" href="#themes">Themes</a></h2>
<p>To use a theme add <code>theme = "&lt;name&gt;"</code> to the top of your <a href="./configuration.html"><code>config.toml</code></a> file, or select it during runtime using <code>:theme &lt;name&gt;</code>.</p>
<p>Separate themes can be configured for light and dark modes. On terminals supporting <a href="https://github.com/contour-terminal/contour/blob/master/docs/vt-extensions/color-palette-update-notifications.md">mode 2031 dark/light detection</a>, the theme mode is detected from the terminal.</p>
<pre><code class="language-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"
</code></pre>
<h2 id="creating-a-theme"><a class="header" href="#creating-a-theme">Creating a theme</a></h2>
<p>Create a file with the name of your theme as the file name (i.e <code>mytheme.toml</code>) and place it in your <code>themes</code> directory (i.e <code>~/.config/helix/themes</code> or <code>%AppData%\helix\themes</code> on Windows). The directory might have to be created beforehand.</p>
<blockquote>

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@@ -162,6 +162,14 @@
<main>
<h2 id="themes"><a class="header" href="#themes">Themes</a></h2>
<p>To use a theme add <code>theme = "&lt;name&gt;"</code> to the top of your <a href="./configuration.html"><code>config.toml</code></a> file, or select it during runtime using <code>:theme &lt;name&gt;</code>.</p>
<p>Separate themes can be configured for light and dark modes. On terminals supporting <a href="https://github.com/contour-terminal/contour/blob/master/docs/vt-extensions/color-palette-update-notifications.md">mode 2031 dark/light detection</a>, the theme mode is detected from the terminal.</p>
<pre><code class="language-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"
</code></pre>
<h2 id="creating-a-theme"><a class="header" href="#creating-a-theme">Creating a theme</a></h2>
<p>Create a file with the name of your theme as the file name (i.e <code>mytheme.toml</code>) and place it in your <code>themes</code> directory (i.e <code>~/.config/helix/themes</code> or <code>%AppData%\helix\themes</code> on Windows). The directory might have to be created beforehand.</p>
<blockquote>