hlargs.nvim 项目教程
1. 项目的目录结构及介绍
hlargs.nvim 项目的目录结构如下:
hlargs.nvim/
├── doc/
│ └── ...
├── lua/
│ └── hlargs/
│ ├── init.lua
│ └── ...
├── queries/
│ └── ...
├── testfiles/
│ └── ...
├── .gitignore
├── .stylua.toml
├── LICENSE
└── README.md
目录结构介绍
- doc/: 存放项目的文档文件。
- lua/hlargs/: 存放项目的主要代码文件,包括
init.lua
和其他相关 Lua 文件。 - queries/: 存放 Treesitter 查询文件。
- testfiles/: 存放测试文件。
- .gitignore: Git 忽略文件配置。
- .stylua.toml: 代码格式化工具 StyLua 的配置文件。
- LICENSE: 项目的开源许可证文件。
- README.md: 项目的介绍和使用说明文件。
2. 项目的启动文件介绍
项目的启动文件是 lua/hlargs/init.lua
。这个文件是 hlargs.nvim 插件的入口点,负责初始化和配置插件的主要功能。
init.lua
文件介绍
- 初始化插件: 该文件包含了插件的初始化逻辑,确保插件在 Neovim 启动时正确加载。
- 配置选项: 提供了用户自定义配置的接口,允许用户根据需要调整插件的行为。
- 功能启用/禁用: 提供了启用、禁用和切换插件功能的接口。
3. 项目的配置文件介绍
hlargs.nvim 的配置主要通过 lua/hlargs/init.lua
文件中的 setup
函数进行。用户可以通过调用 require('hlargs').setup()
来配置插件。
配置选项介绍
- color: 设置高亮颜色。
- highlight: 设置高亮组。
- excluded_filetypes: 排除某些文件类型。
- disable: 自定义禁用逻辑。
- paint_arg_declarations: 是否高亮参数声明。
- paint_arg_usages: 是否高亮参数使用。
- paint_catch_blocks: 是否高亮 catch 块。
- extras: 额外的配置选项。
- hl_priority: 高亮优先级。
- excluded_argnames: 排除某些参数名。
- performance: 性能相关配置。
示例配置
require('hlargs').setup {
color = '#ef9062',
highlight = [],
excluded_filetypes = [],
disable = function(lang, bufnr)
return vim.tbl_contains(opts.excluded_filetypes, lang)
end,
paint_arg_declarations = true,
paint_arg_usages = true,
paint_catch_blocks = {
declarations = false,
usages = false
},
extras = {
named_parameters = false,
},
hl_priority = 120,
excluded_argnames = {
declarations = [],
usages = {
python = ['self', 'cls'],
lua = ['self']
}
},
performance = {
parse_delay = 1,
slow_parse_delay = 50,
max_iterations = 400,
max_concurrent_partial_parses = 30,
debounce = {
partial_parse = 3,
partial_insert_mode = 100,
total_parse = 700,
slow_parse = 5000
}
}
}
通过以上配置,用户可以根据自己的需求调整 hlargs.nvim 插件的行为,以获得最佳的使用体验。