reo101 b8d1ffe58a fix(fennel): update queries to reflect new upstream parser
https://github.com/nvim-treesitter/nvim-treesitter/pull/6132
2024-02-25 17:40:08 +00:00
.github test: migrate to nvim-test 2024-02-14 15:48:50 +00:00
lua fix: Display context when injected language is not supported 2024-02-20 01:10:24 +00:00
plugin refactor: autocmds and setup 2023-08-28 16:36:18 +01:00
queries fix(fennel): update queries to reflect new upstream parser 2024-02-25 17:40:08 +00:00
static implement highlights for partial nodes 2020-10-20 19:10:00 -04:00
test feat(rust): add more queries and tests 2024-02-24 07:30:14 +00:00
.gitattributes chore: ignore test languages 2024-01-08 15:36:21 +00:00
.gitignore test: migrate to nvim-test 2024-02-14 15:48:50 +00:00
.luacheckrc Fix luacheck errors 2020-12-31 11:32:29 +00:00
.luarc.json test: migrate to nvim-test 2024-02-14 15:48:50 +00:00
.stylua.toml chore: formatting 2023-07-13 09:53:14 +01:00
CONTRIBUTING.md doc: add CONTRIBUTING.md 2023-05-11 10:50:42 +01:00
LICENSE doc: add license 2021-07-31 21:09:40 -04:00
Makefile test: migrate to nvim-test 2024-02-14 15:48:50 +00:00
README.md fix: Display context when injected language is not supported 2024-02-20 01:10:24 +00:00

README.md

nvim-treesitter-context

Lightweight alternative to context.vim

Requirements

Neovim >= v0.9.0

Note: if you need support for Neovim 0.6.x please use the tag compat/0.6.

Screenshot

theme

Supported Languages

click to expand
  • apex
  • bash
  • c
  • c_sharp
  • capnp
  • clojure
  • cmake
  • cpp
  • css
  • cuda
  • cue
  • d
  • dart
  • elixir
  • fennel
  • fish
  • fortran
  • glimmer
  • go
  • graphql
  • groovy
  • haskell
  • html_tags
  • ini
  • janet (using the "janet_simple" grammar)
  • java
  • javascript
  • json
  • jsonnet
  • julia
  • latex
  • liquidsoap
  • lua
  • markdown
  • matlab
  • nim
  • nix
  • norg
  • objdump
  • ocaml_interface
  • ocaml
  • odin
  • php
  • php_only
  • prisma
  • python
  • r
  • ruby
  • rust
  • scala
  • scss
  • smali
  • solidity
  • svelte
  • swift
  • tcl
  • teal
  • templ
  • terraform
  • toml
  • tsx
  • typescript
  • typoscript
  • usd
  • verilog
  • vim
  • vue
  • xml
  • yaml
  • yang
  • zig
  • ada
  • agda
  • arduino
  • astro
  • beancount
  • bibtex
  • bicep
  • blueprint
  • chatito
  • clojure
  • commonlisp
  • cooklang
  • cpon
  • devicetree
  • dhall
  • dockerfile
  • dot
  • ebnf
  • ecma
  • eex
  • elm
  • elsa
  • elvish
  • embedded_template
  • erlang
  • fennel
  • foam
  • fsh
  • func
  • fusion
  • gdscript
  • git_rebase
  • gleam
  • glsl
  • godot_resource
  • gomod
  • gosum
  • gowork
  • hack
  • hcl
  • heex
  • hjson
  • hlsl
  • hocon
  • html
  • htmldjango
  • http
  • jq
  • jsdoc
  • json5
  • jsonc
  • jsx
  • kdl
  • kotlin
  • lalrpop
  • ledger
  • llvm
  • m68k
  • markdown_inline
  • menhir
  • mermaid
  • meson
  • nickel
  • ocamllex
  • pascal
  • perl
  • phpdoc
  • pioasm
  • po
  • poe_filter
  • proto
  • prql
  • pug
  • ql
  • qmldir
  • qmljs
  • query
  • racket
  • rasi
  • rego
  • rnoweb
  • ron
  • rst
  • scheme
  • slint
  • smithy
  • sparql
  • sql
  • starlark
  • supercollider
  • surface
  • sxhkdrc
  • t32
  • thrift
  • tiger
  • tlaplus
  • todotxt
  • turtle
  • twig
  • ungrammar
  • v
  • vala
  • vhs
  • wgsl
  • wgsl_bevy
  • yuck
  • Configuration

    (Default values are shown below)

    Note: calling setup() is optional.

    require'treesitter-context'.setup{
      enable = true, -- Enable this plugin (Can be enabled/disabled later via commands)
      max_lines = 0, -- How many lines the window should span. Values <= 0 mean no limit.
      min_window_height = 0, -- Minimum editor window height to enable context. Values <= 0 mean no limit.
      line_numbers = true,
      multiline_threshold = 20, -- Maximum number of lines to show for a single context
      trim_scope = 'outer', -- Which context lines to discard if `max_lines` is exceeded. Choices: 'inner', 'outer'
      mode = 'cursor',  -- Line used to calculate context. Choices: 'cursor', 'topline'
      -- Separator between context and content. Should be a single character string, like '-'.
      -- When separator is set, the context will only show up when there are at least 2 lines above cursorline.
      separator = nil,
      zindex = 20, -- The Z-index of the context window
      on_attach = nil, -- (fun(buf: integer): boolean) return false to disable attaching
    }
    

    Commands

    TSContextEnable, TSContextDisable and TSContextToggle.

    Appearance

    Use the highlight group TreesitterContext to change the colors of the context. Per default it links to NormalFloat.

    Use the highlight group TreesitterContextLineNumber to change the colors of the context line numbers if line_numbers is set. Per default it links to LineNr.

    Use the highlight group TreesitterContextSeparator to change the colors of the separator if separator is set. By default it links to FloatBorder.

    Use the highlight groups TreesitterContextBottom and/or TreesitterContextLineNumberBottom to change the highlight of the last line of the context window. By default it links to NONE. However, you can use this to create a border by applying an underline highlight, e.g, for an underline across the screen:

    hi TreesitterContextBottom gui=underline guisp=Grey
    hi TreesitterContextLineNumberBottom gui=underline guisp=Grey
    

    Or an underline below the line numbers only:

    hi TreesitterContextLineNumberBottom gui=underline guisp=Grey
    

    Jumping to context (upwards)

    vim.keymap.set("n", "[c", function()
      require("treesitter-context").go_to_context(vim.v.count1)
    end, { silent = true })
    

    Adding support for other languages

    See CONTRIBUTING.md