https://github.com/uncenter/tree-sitter-tera
⛩️ Tree-sitter grammar for the Tera templating language.
https://github.com/uncenter/tree-sitter-tera
helix neovim tera tree-sitter
Last synced: 5 months ago
JSON representation
⛩️ Tree-sitter grammar for the Tera templating language.
- Host: GitHub
- URL: https://github.com/uncenter/tree-sitter-tera
- Owner: uncenter
- License: mit
- Created: 2024-10-17T16:33:41.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-16T12:51:57.000Z (6 months ago)
- Last Synced: 2025-04-30T06:48:11.447Z (5 months ago)
- Topics: helix, neovim, tera, tree-sitter
- Language: JavaScript
- Homepage:
- Size: 1.48 MB
- Stars: 16
- Watchers: 1
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tree-sitter-tera
[Tree-sitter](https://tree-sitter.github.io/tree-sitter/) grammar and syntax highlight queries for the [Tera](https://keats.github.io/tera/) templating language.
> [!TIP]
> For Visual Studio Code support, see [uncenter/vscode-tera](https://github.com/uncenter/vscode-tera). For Zed support, see [uncenter/zed-tera](https://github.com/uncenter/zed-tera). For Sublime Text support, see [MuntasirSZN/sublime-tera](https://github.com/MuntasirSZN/sublime-tera).
## Usage
### Neovim
> [!IMPORTANT]
> Requires Neovim v0.11 or later.
Install the grammar by running the following command inside Neovim:
```
:TSInstall tera
```
### Helix
> [!NOTE]
> As of 2025-02-02, tree-sitter-tera is included for Tera language support in Helix (unreleased).
1. Add the following language and grammar configuration to your own [`languages.toml` configuration file](https://docs.helix-editor.com/configuration.html):
```toml
[[grammar]]
name = "tera"
[grammar.source]
git = "https://github.com/uncenter/tree-sitter-tera"
rev = "main"
[[language]]
file-types = ["tera"]
grammar = "tera"
injection-regex = "tera"
name = "tera"
scope = "source.tera"
block-comment-tokens = [
{ start = "{#", end = "#}" },
{ start = "{#-", end = "-#}" },
{ start = "{#", end = "-#}" },
{ start = "{#-", end = "#}" },
]
[language.auto-pairs]
"\"" = "\""
"'" = "'"
"`" = "`"
"(" = ")"
"[" = "]"
"{" = "}"
"%" = "%"
```
2. Run `hx --grammar fetch` to fetch the grammar from this repository, and then `hx --grammar build` to build the grammars.
3. Run `just helix sync` or `just helix link` to copy or symlink the [Helix-specific queries](./helix-queries) to Helix's runtime directory, as unfortunately [queries are not used from the grammar repository by default](https://github.com/helix-editor/helix/discussions/11379#discussioncomment-10194806).
> [!IMPORTANT]
> Helix [uses the reverse query precedence ordering](https://github.com/helix-editor/helix/issues/9436), meaning that the _first_ matching highlight query is used rather than last; this is the opposite behavior of Neovim and Zed, both of which use the _last_ matching highlight query - think of it like CSS, where queries gain precedence by being located further down. Helix does seemingly plan to change this soon, but for now this repository has a separate folder for Helix-converted queries (built with `just helix build`, using [tree-sitter-query-reverser](https://github.com/uncenter/tree-sitter-query-reverser).
## License
[MIT](LICENSE)