Skip to content

This is the lua implementation of nvim-hlchunk, you can use this neovim plugin to highlight your indent line and the current chunk (context) your cursor stayed

License

Notifications You must be signed in to change notification settings

pauldesmondparker/hlchunk.nvim

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hlchunk.nvim

English | 简体中文

What can this plugin do

similar to indent-blankline, this plugin can highlight the indent line, and highlight the code chunk according to the current cursor position.

What is the advantage of this plugin

  1. more extensible
  2. faster rendering speed (0.04 seconds per thousand renderings, with the window have 50 lines)
  3. more active maintenance (the author is a student with a lot of time to maintain this plugin, haha)

Brief introduction

this plugin now have five parts (future will add more... ^v^)

  1. chunk
  2. indent
  3. line_num
  4. blank
  5. context (experimental)

one picture to understand what these mods do

more details about each mod

NOTE: you can click the picture to get more information about how to configure like this

chunk

image

indent

image image image

line_num

image

blank

image

Requirements

neovim version >= 0.7.0

Installation

Packer

use { "shellRaining/hlchunk.nvim" }

Plug

Plug "shellRaining/hlchunk.nvim"

Lazy

{ "shellRaining/hlchunk.nvim", event = { "UIEnter" }, },

Setup

The script comes with the following defaults:

Click this Dropdown to see defaults setttings.
{
    chunk = {
        enable = true,
        use_treesitter = true,
        notify = true, -- notify if some situation(like disable chunk mod double time)
        exclude_filetypes = {
            aerial = true,
            dashboard = true,
        },
        support_filetypes = {
            "*.lua",
            "*.js",
        },
        chars = {
            horizontal_line = "",
            vertical_line = "",
            left_top = "",
            left_bottom = "",
            right_arrow = ">",
        },
        style = {
            { fg = "#806d9c" },
        },
    },

    indent = {
        enable = true,
        use_treesitter = false,
        chars = {
            "",
        },
        style = {
            { fg = vim.fn.synIDattr(vim.fn.synIDtrans(vim.fn.hlID("Whitespace")), "fg", "gui") }
        },
    },

    line_num = {
        enable = true,
        use_treesitter = false,
        style = "#806d9c",
    },

    blank = {
        enable = true,
        chars = {
            "",
        },
        style = {
            vim.fn.synIDattr(vim.fn.synIDtrans(vim.fn.hlID("Whitespace")), "fg", "gui"),
        },
    },
}


setup example:

require('hlchunk').setup({
    indent = {
        chars = { "", "¦", "", "", }, -- more code can be found in https://unicodeplus.com/

        style = {
            "#8B00FF",
        },
    },
    blank = {
        enable = false,
    }
})

command

Click this Dropdown to see Available Commands

this plugin provides some commands to switch plugin status, which are listed below

  • EnableHL
  • DisableHL

the two commands are used to switch the whole plugin status, when use DisableHL, include hl_chunk and hl_indent will be disable

  • DisableHLChunk
  • EnableHLChunk

the two will control hl_chunk

  • DisableHLIndent
  • EnableHLIndent

the two will control hl_indent

  • DisableHLLineNum
  • EnableHLLineNum

the two will control hl_line_num

  • DisableHLBlank
  • EnableHLBlank

the two will control hl_blank

About

This is the lua implementation of nvim-hlchunk, you can use this neovim plugin to highlight your indent line and the current chunk (context) your cursor stayed

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Lua 100.0%