tree-sitter-rstml
v1.2.0
Published
Rust + html grammar for the tree-sitter parser library.
Downloads
175
Readme
tree-sitter-rstml
Rust + html grammar for the tree-sitter parser library.
Rust web frameworks, like Leptos, rely on JSX-style templates embedded inside Rust code using the rstml library. This project enables the parsing of those templates for various purposes, such as syntax highlighting in text editors.
Usage
Since rstml isn't a supposed to be a standalone language, there are two grammars defined for convenience:
Editor support
Neovim
Neovim's tree-sitter integration supports syntax highlighting, indentation, and code folding.
| Without rstml
highlighting | With rstml
highlighting |
|---------------------------------------------------|-------------------------------------------------|
| | |
To use the Neovim support with nvim-treesitter, you should:
- Ensure
"nvim-treesitter/nvim-treesitter"
is installed and configured correctly. - Install the
"rayliwell/tree-sitter-rstml"
plugin in your preferred package manager. - Ensure
require("tree-sitter-rstml").setup()
is ran after everytimenvim-treesitter
is loaded.
Here's an example config using lazy.nvim:
require("lazy").setup({
{
"rayliwell/nvim-treesitter",
build = ":TSUpdate",
config = function ()
local configs = require("nvim-treesitter.configs")
configs.setup({
ensure_installed = { "c", "lua", "vim", "vimdoc", "query", "rust" },
sync_install = false,
highlight = { enable = true },
indent = { enable = true },
})
end
},
{
"rayliwell/tree-sitter-rstml",
dependencies = { "nvim-treesitter" },
build = ":TSUpdate",
config = function ()
require("tree-sitter-rstml").setup()
end
},
})
Emacs
Emacs' (29.1+) tree-sitter integration supports syntax highlighting and indentation.
| Before (rust-ts-mode
) | After (rstml-ts-mode
) |
|--------------------------------------------------|------------------------------------------------|
| | |
Emacs support is provided by the rstml-ts-mode
package. Installation instructions can be found on the project's GitHub.
Acknowledgements
This project extends and heavily relies upon the tree-sitter-rust grammar. It would not be possible without its contributors, as well as those who have contributed to the wider tree-sitter ecosystem.
Additionally, this project is based on the work of the rstml library. Originating as a fork of syn-rsx, whose creator, unfortunately, has passed away.
License
Licensed under the MIT License.
Copyright © 2024 Ryan Halliwell