git.iko.soy/helix
on master help sign in
Rewrite Language Support docs (#2065)
3d79c60Michael Davis
book/src/guides/adding_languages.md+6−2
compare with master
unifiedsplit
@@ -37,9 +37,11 @@ These are the available keys and descriptions for the file.
37| `config` | Language Server configuration |
37| `config` | Language Server configuration |
38| `grammar` | The tree-sitter grammar to use (defaults to the value of `name`) |
38| `grammar` | The tree-sitter grammar to use (defaults to the value of `name`) |
39
39
40+When adding a new language or Language Server configuration for an existing
41+language, run `cargo xtask docgen` to add the new configuration to the
42+[Language Support][lang-support] docs before creating a pull request.
40When adding a Language Server configuration, be sure to update the
43When adding a Language Server configuration, be sure to update the
41−[Language Server Wiki](https://github.com/helix-editor/helix/wiki/How-to-install-the-default-language-servers)
42−with installation notes.
44+[Language Server Wiki][install-lsp-wiki] with installation notes.
43
45
44## Grammar configuration
46## Grammar configuration
45
47
@@ -94,3 +96,5 @@ the last matching query supersedes the ones before it. See
94[treesitter-language-injection]: https://tree-sitter.github.io/tree-sitter/syntax-highlighting#language-injection
96[treesitter-language-injection]: https://tree-sitter.github.io/tree-sitter/syntax-highlighting#language-injection
95[languages.toml]: https://github.com/helix-editor/helix/blob/master/languages.toml
97[languages.toml]: https://github.com/helix-editor/helix/blob/master/languages.toml
96[neovim-query-precedence]: https://github.com/helix-editor/helix/pull/1170#issuecomment-997294090
98[neovim-query-precedence]: https://github.com/helix-editor/helix/pull/1170#issuecomment-997294090
99+[install-lsp-wiki]: https://github.com/helix-editor/helix/wiki/How-to-install-the-default-language-servers
100+[lang-support]: ../lang-support.md
book/src/lang-support.md+11−5
@@ -1,10 +1,16 @@
1# Language Support
1# Language Support
2
2
3−For more information like arguments passed to default LSP server,
3+The following languages and Language Servers are supported. In order to use
4−extensions assosciated with a filetype, custom LSP settings, filetype
4+Language Server features, you must first [install][lsp-install-wiki] the
5−specific indent settings, etc see the default
5+appropriate Language Server.
6−[`languages.toml`][languages.toml] file.
6+
7+Check the language support in your installed helix version with `hx --health`.
8+
9+Also see the [Language Configuration][lang-config] docs and the [Adding
10+Languages][adding-languages] guide for more language configuration information.
7
11
8{{#include ./generated/lang-support.md}}
12{{#include ./generated/lang-support.md}}
9
13
10−[languages.toml]: https://github.com/helix-editor/helix/blob/master/languages.toml
14+[lsp-install-wiki]: https://github.com/helix-editor/helix/wiki/How-to-install-the-default-language-servers
15+[lang-config]: ./languages.md
16+[adding-languages]: ./guides/adding_languages.md
languages.toml+3
@@ -1,3 +1,6 @@
1+# Language support configuration.
2+# See the languages documentation: https://docs.helix-editor.com/master/languages.html
3+
1[[language]]
4[[language]]
2name = "rust"
5name = "rust"
3scope = "source.rust"
6scope = "source.rust"