README update, doc helpfile added

main
bhagwan 3 years ago
parent dc49182ea6
commit 892990262d

1
.gitignore vendored

@ -0,0 +1 @@
doc/tags

@ -12,7 +12,7 @@
</div>
### Rationale
## Rationale
What more can be said about [fzf](https://github.com/junegunn/fzf)? It is the
single most impactful tool for my command line workflow, once I started using
@ -28,7 +28,7 @@ it builds on the elegant
create a performant and lightweight fzf client for neovim that rivals any of
the new shiny fuzzy finders for neovim.
### Why use this plug-in?
## Why Fzf-Lua
... and not, to name a few,
[telescope](https://github.com/nvim-telescope/telescope.nvim) or
@ -45,23 +45,25 @@ nvim. In addition `fzf` has been a rock for me since I started using it and
hadnt failed me once, it never hangs and can handle almost anything you throw
at it. That, **and colorful file icons and git indicators!**.
### Dependencies
## Dependencies
- `Linux` or `MacOS` only, see [nvim-fzf's How it
works](https://github.com/vijaymarupudi/nvim-fzf#How-it-works) section
works](https://github.com/vijaymarupudi/nvim-fzf#How-it-works)
- [`fzf`](https://github.com/junegunn/fzf) or
[`skim`](https://github.com/lotabout/skim) binary installed
- [nvim-fzf](https://github.com/vijaymarupudi/nvim-fzf)
- [nvim-web-devicons](https://github.com/kyazdani42/nvim-web-devicons)
(optional)
### Optional dependencies (recommended)
### Optional dependencies
Recommended optional utilities:
- [fd](https://github.com/sharkdp/fd) - better performance `find` utility
- [bat](https://github.com/sharkdp/bat) - for colorful syntax highlighted previews
- [ripgrep](https://github.com/BurntSushi/ripgrep) - for better grep-like searches
### Installation
## Installation
Using [vim-plug](https://github.com/junegunn/vim-plug)
@ -123,74 +125,74 @@ vim.api.nvim_set_keymap('n', '<c-P>',
## Commands
### Buffers & Files
| Command | List |
| --- | --- |
|`buffers`|open buffers|
|`files`|`find` or `fd` on a path|
|`files_resume`|continious query find|
|`oldfiles`|opened files history|
|`quickfix`|quickfix list|
|`loclist`|location list|
|`lines`|open buffers lines|
|`blines`|current buffer lines|
|`tabs`|open tabs|
### Buffers and Files
| Command | List |
| ---------------- | ------------------------------------------ |
| `buffers` | open buffers |
| `files` | `find` or `fd` on a path |
| `files_resume` | continious query find |
| `oldfiles` | opened files history |
| `quickfix` | quickfix list |
| `loclist` | location list |
| `lines` | open buffers lines |
| `blines` | current buffer lines |
| `tabs` | open tabs |
### Search
| Command | List |
| --- | --- |
|`grep`|search for a pattern with `grep` or `rg`|
|`grep_last`|run search again with the last pattern|
|`grep_cword`|search word under cursor|
|`grep_cWORD`|search WORD under cursor|
|`grep_visual`|search visual selection|
|`grep_curbuf`|live grep current buffer|
|`live_grep`|live grep current project|
|`live_grep_resume`|live grep continue last search|
| Command | List |
| ---------------- | ------------------------------------------ |
| `grep` | search for a pattern with `grep` or `rg` |
| `grep_last` | run search again with the last pattern |
| `grep_cword` | search word under cursor |
| `grep_cWORD` | search WORD under cursor |
| `grep_visual` | search visual selection |
| `grep_curbuf` | live grep current buffer |
| `live_grep` | live grep current project |
| `live_grep_resume` | live grep continue last search |
### Git
| Command | List |
| --- | --- |
|`git_files`|`git ls-files`|
|`git_status`|`git status`|
|`git_commits`|git commit log (project)|
|`git_bcommits`|git commit log (buffer)|
|`git_branches`|git branches|
| Command | List |
| ---------------- | ------------------------------------------ |
| `git_files` | `git ls-files` |
| `git_status` | `git status` |
| `git_commits` | git commit log (project) |
| `git_bcommits` | git commit log (buffer) |
| `git_branches` | git branches |
### LSP
| Command | List |
| --- | --- |
|`lsp_references`|References|
|`lsp_definitions`|Definitions|
|`lsp_declarations`|Declarations|
|`lsp_typedefs`|Type Definitions|
|`lsp_implementations`|Implementations|
|`lsp_document_symbols`|Document Symbols|
|`lsp_workspace_symbols`|Workspace Symbols|
|`lsp_live_workspace_symbols`|Workspace Symbols (live query)|
|`lsp_code_actions`|Code Actions|
|`lsp_document_diagnostics`|Document Diagnostics|
|`lsp_workspace_diagnostics`|Workspace Diagnostics|
| Command | List |
| ---------------- | ------------------------------------------ |
| `lsp_references` | References |
| `lsp_definitions` | Definitions |
| `lsp_declarations` | Declarations |
| `lsp_typedefs` | Type Definitions |
| `lsp_implementations` | Implementations |
| `lsp_document_symbols` | Document Symbols |
| `lsp_workspace_symbols` | Workspace Symbols |
| `lsp_live_workspace_symbols` | Workspace Symbols (live query) |
| `lsp_code_actions` | Code Actions |
| `lsp_document_diagnostics` | Document Diagnostics |
| `lsp_workspace_diagnostics` | Workspace Diagnostics |
### Misc
| Command | List |
| --- | --- |
|`builtin`|fzf-lua builtin methods|
|`help_tags`|help tags|
|`man_pages`|man pages|
|`colorschemes`|color schemes|
|`commands`|neovim commands|
|`command_history`|command history|
|`search_history`|search history|
|`marks`|:marks|
|`registers`|:registers|
|`keymaps`|key mappings|
|`spell_suggest`|spelling suggestions|
|`tags`|project tags|
|`btags`|buffer tags|
|`filetypes`|neovim filetypes|
|`packadd`|:packadd <package>|
| Command | List |
| ---------------- | ------------------------------------------ |
| `builtin` | fzf-lua builtin commands |
| `help_tags` | help tags |
| `man_pages` | man pages |
| `colorschemes` | color schemes |
| `commands` | neovim commands |
| `command_history` | command history |
| `search_history` | search history |
| `marks` | :marks |
| `registers` | :registers |
| `keymaps` | key mappings |
| `spell_suggest` | spelling suggestions |
| `tags` | project tags |
| `btags` | buffer tags |
| `filetypes` | neovim filetypes |
| `packadd` | :packadd <package> |
## Customization
@ -473,7 +475,7 @@ require'fzf-lua'.setup {
}
```
This can also be run from a `.vim` file using
This can also be run from a `.vim` file using:
```lua
lua << EOF
@ -483,28 +485,7 @@ require('fzf-lua').setup{
EOF
```
## TODO
- [x] ~~Add more providers~~
+ [x] ~~LSP (refs, symbols, etc)~~ (2021-07-20)
+ [x] ~~git commits~~ (2021-08-05)
+ [x] ~~git branches~~ (2021-08-05)
+ [x] nvim built-in:
* [x] ~~commands~~ (2021-08-14)
* [x] ~~command history~~ (2021-08-14)
* [x] ~~search history~~ (2021-08-14)
* [x] ~~registers~~ (2021-08-14)
* [x] ~~keymaps~~ (2021-08-14)
* [x] ~~spelling suggestions~~ (2021-08-14)
* [x] ~~marks~~ (2021-08-14)
+ [x] ~~tags~~ (2021-08-15)
- [x] ~~Built-in previewer with treesitter support~~ (2021-08-29)
- [x] ~~Improve previewer for `buffers`~~ (2021-08-29)
- [x] ~~Add builtin previews for `marks|help_tags|man_pages`~~ (2021-09-09)
- [ ] Add built-in plugin documentation
- [ ] Complete the Wiki
### Credits
## Credits
Big thank you to all those I borrowed code/ideas from, I read so many configs
and plugin codes that I probably forgot where I found some samples from so if
@ -525,3 +506,6 @@ I missed your name feel free to contact me and I'll add it below:
[indent-blankline](https://github.com/lukas-reineke/indent-blankline.nvim)
- [@sindrets](https://github.com/sindrets) for borrowing utilities from his
fantastic lua plugin [diffview.nvim](https://github.com/sindrets/diffview.nvim)
- [@kevinhwang91](https://github.com/kevinhwang91) for using his previewer
code as baseline for the builtin previewer and his must have plugin
[nvim-bqf](https://github.com/kevinhwang91/nvim-bqf)

@ -0,0 +1,549 @@
==============================================================================
FZF :HEART: LUA *fzf-lua-fzf-:heart:-lua*
Neovim version
<https://img.shields.io/badge/Neovim-0.5-57A143?style=flat-square&logo=neovim>
Installation <#installation> • Usage <#usage> • Commands <#commands> •
Customization <#customization> • Wiki
<https://github.com/ibhagwan/fzf-lua/wiki>
screenshot
<https://raw.githubusercontent.com/ibhagwan/fzf-lua/main/screenshots/main.png>
fzf <https://github.com/junegunn/fzf> changed my life, it can change yours too,
if you allow it.
------------------------------------------------------------------------------
RATIONALE *fzf-lua-rationale*
What more can be said about fzf <https://github.com/junegunn/fzf>? It is the
single most impactful tool for my command line workflow, once I started using
fzf I couldnt see myself living without it.
To understand fzf properly I highly recommended fzf screencast
<https://www.youtube.com/watch?v=qgG5Jhi_Els> by @samoshkin
<https://github.com/samoshkin>
This is my take on the original fzf.vim <https://github.com/junegunn/fzf.vim>,
written in lua for neovim 0.5, it builds on the elegant nvim-fzf
<https://github.com/vijaymarupudi/nvim-fzf> as an async interface to create a
performant and lightweight fzf client for neovim that rivals any of the new
shiny fuzzy finders for neovim.
------------------------------------------------------------------------------
WHY FZF-LUA *fzf-lua-why-fzf-lua*
... and not, to name a few, telescope
<https://github.com/nvim-telescope/telescope.nvim> or vim-clap
<https://github.com/liuchengxu/vim-clap>?
As @junegunn <https://github.com/junegunn> himself put it, “because you can
and you love fzf ”.
If youre happy with your current setup there is absolutely no reason to
switch.
That said, without taking anything away from the greatness of other plugins I
found it more efficient having a uniform experience between my shell and my
nvim. In addition fzf has been a rock for me since I started using it and
hadnt failed me once, it never hangs and can handle almost anything you
throw at it. That, and colorful file icons and git indicators!.
------------------------------------------------------------------------------
DEPENDENCIES *fzf-lua-dependencies*
- `Linux` or `MacOS` only, see nvim-fzf's How it
works <https://github.com/vijaymarupudi/nvim-fzf#How-it-works>
- `fzf` <https://github.com/junegunn/fzf> or
`skim` <https://github.com/lotabout/skim> binary installed
- nvim-fzf <https://github.com/vijaymarupudi/nvim-fzf>
- nvim-web-devicons <https://github.com/kyazdani42/nvim-web-devicons>
(optional)
OPTIONAL DEPENDENCIES *fzf-lua-optional-dependencies*
Recommended optional utilities:
- fd <https://github.com/sharkdp/fd> - better performance `find` utility
- bat <https://github.com/sharkdp/bat> - for colorful syntax highlighted previews
- ripgrep <https://github.com/BurntSushi/ripgrep> - for better grep-like searches
------------------------------------------------------------------------------
INSTALLATION *fzf-lua-installation*
Using vim-plug <https://github.com/junegunn/vim-plug>
>
Plug 'ibhagwan/fzf-lua'
Plug 'vijaymarupudi/nvim-fzf'
Plug 'kyazdani42/nvim-web-devicons'
<
Using packer.nvim <https://github.com/wbthomason/packer.nvim>
>
use { 'ibhagwan/fzf-lua',
requires = {
'vijaymarupudi/nvim-fzf',
'kyazdani42/nvim-web-devicons' } -- optional for icons
}
<
Note: if you already have fzf installed you do not need to install fzf or
fzf.vim , however if you do not have it installed, you only need fzf which can
be installed with (fzf.vim is not a requirement nor conflict):
>
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
<
or with packer.nvim <https://github.com/wbthomason/packer.nvim>:
>
use = { 'junegunn/fzf', run = './install --bin', }
<
------------------------------------------------------------------------------
USAGE *fzf-lua-usage*
Fzf-lua aims to be as plug and play as possible with sane defaults, you can run
any fzf-lua command like this:
>
:lua require('fzf-lua').files()
-- or using the `FzfLua` vim command:
:FzfLua files
<
or with arguments:
>
:lua require('fzf-lua').files({ cwd = '~/.config' })
-- or using the `FzfLua` vim command:
:FzfLua files cwd=~/.config
<
which can be easily mapped to:
>
nnoremap <c-P> <cmd>lua require('fzf-lua').files()<CR>
<
or if using init.lua :
>
vim.api.nvim_set_keymap('n', '<c-P>',
"<cmd>lua require('fzf-lua').files()<CR>",
{ noremap = true, silent = true })
<
------------------------------------------------------------------------------
COMMANDS *fzf-lua-commands*
BUFFERS AND FILES *fzf-lua-buffers-and-files*
| Command | List |
| ---------------- | ------------------------------------------ |
| `buffers` | open buffers |
| `files` | `find` or `fd` on a path |
| `files_resume` | continious query find |
| `oldfiles` | opened files history |
| `quickfix` | quickfix list |
| `loclist` | location list |
| `lines` | open buffers lines |
| `blines` | current buffer lines |
| `tabs` | open tabs |
SEARCH *fzf-lua-search*
| Command | List |
| ---------------- | ------------------------------------------ |
| `grep` | search for a pattern with `grep` or `rg` |
| `grep_last` | run search again with the last pattern |
| `grep_cword` | search word under cursor |
| `grep_cWORD` | search WORD under cursor |
| `grep_visual` | search visual selection |
| `grep_curbuf` | live grep current buffer |
| `live_grep` | live grep current project |
| `live_grep_resume` | live grep continue last search |
GIT *fzf-lua-git*
| Command | List |
| ---------------- | ------------------------------------------ |
| `git_files` | `git ls-files` |
| `git_status` | `git status` |
| `git_commits` | git commit log (project) |
| `git_bcommits` | git commit log (buffer) |
| `git_branches` | git branches |
LSP *fzf-lua-lsp*
| Command | List |
| ---------------- | ------------------------------------------ |
| `lsp_references` | References |
| `lsp_definitions` | Definitions |
| `lsp_declarations` | Declarations |
| `lsp_typedefs` | Type Definitions |
| `lsp_implementations` | Implementations |
| `lsp_document_symbols` | Document Symbols |
| `lsp_workspace_symbols` | Workspace Symbols |
| `lsp_live_workspace_symbols` | Workspace Symbols (live query) |
| `lsp_code_actions` | Code Actions |
| `lsp_document_diagnostics` | Document Diagnostics |
| `lsp_workspace_diagnostics` | Workspace Diagnostics |
MISC *fzf-lua-misc*
| Command | List |
| ---------------- | ------------------------------------------ |
| `builtin` | fzf-lua builtin commands |
| `help_tags` | help tags |
| `man_pages` | man pages |
| `colorschemes` | color schemes |
| `commands` | neovim commands |
| `command_history` | command history |
| `search_history` | search history |
| `marks` | :marks |
| `registers` | :registers |
| `keymaps` | key mappings |
| `spell_suggest` | spelling suggestions |
| `tags` | project tags |
| `btags` | buffer tags |
| `filetypes` | neovim filetypes |
| `packadd` | :packadd <package> |
------------------------------------------------------------------------------
CUSTOMIZATION *fzf-lua-customization*
I tried to make it as customizable as possible, if you find you need to change
something that isnt below, open an issue and Ill do my best to add it.
customization can be achieved by calling the setup() function or individually
sending parameters to a builtin command, for exmaple:
>
:lua require('fzf-lua').files({ fzf_layout = 'reverse-list' })
<
Consult the list below for available settings:
>
local actions = require "fzf-lua.actions"
require'fzf-lua'.setup {
winopts = {
-- split = "belowright new",-- open in a split instead?
-- "belowright new" : split below
-- "aboveleft new" : split above
-- "belowright vnew" : split right
-- "aboveleft vnew : split left
win_height = 0.85, -- window height
win_width = 0.80, -- window width
win_row = 0.30, -- window row position (0=top, 1=bottom)
win_col = 0.50, -- window col position (0=left, 1=right)
-- win_border = false, -- window border? or borderchars?
win_border = { '╭', '─', '╮', '│', '╯', '─', '╰', '│' },
hl_normal = 'Normal', -- window normal color
hl_border = 'FloatBorder', -- window border color
},
-- fzf_bin = 'sk', -- use skim instead of fzf?
fzf_layout = 'reverse', -- fzf '--layout=' options
fzf_args = '', -- adv: fzf extra args, empty unless adv
fzf_binds = { -- fzf '--bind=' options
["f2"] = "toggle-preview",
["f3"] = "toggle-preview-wrap",
["shift-down"] = "preview-page-down",
["shift-up"] = "preview-page-up",
["ctrl-u"] = "unix-line-discard",
["ctrl-f"] = "half-page-down",
["ctrl-b"] = "half-page-up",
["ctrl-a"] = "beginning-of-line",
["ctrl-e"] = "end-of-line",
["alt-a"] = "toggle-all",
},
--[[ fzf_colors = { -- fzf '--color=' options
["fg"] = { "fg", "CursorLine" },
["bg"] = { "bg", "Normal" },
["hl"] = { "fg", "Comment" },
["fg+"] = { "fg", "Normal" },
["bg+"] = { "bg", "CursorLine" },
["hl+"] = { "fg", "Statement" },
["info"] = { "fg", "PreProc" },
["prompt"] = { "fg", "Conditional" },
["pointer"] = { "fg", "Exception" },
["marker"] = { "fg", "Keyword" },
["spinner"] = { "fg", "Label" },
["header"] = { "fg", "Comment" },
["gutter"] = { "bg", "Normal" },
}, ]]
preview_border = 'border', -- border|noborder
preview_wrap = 'nowrap', -- wrap|nowrap
preview_opts = 'nohidden', -- hidden|nohidden
preview_vertical = 'down:45%', -- up|down:size
preview_horizontal = 'right:60%', -- right|left:size
preview_layout = 'flex', -- horizontal|vertical|flex
flip_columns = 120, -- #cols to switch to horizontal on flex
-- default_previewer = "bat", -- override the default previewer?
-- by default uses the builtin previewer
previewers = {
cat = {
cmd = "cat",
args = "--number",
},
bat = {
cmd = "bat",
args = "--style=numbers,changes --color always",
theme = 'Coldark-Dark', -- bat preview theme (bat --list-themes)
config = nil, -- nil uses $BAT_CONFIG_PATH
},
head = {
cmd = "head",
args = nil,
},
git_diff = {
cmd = "git diff",
args = "--color",
},
builtin = {
title = true, -- preview title?
scrollbar = true, -- scrollbar?
scrollchar = '█', -- scrollbar character
wrap = false, -- wrap lines?
syntax = true, -- preview syntax highlight?
syntax_limit_l = 0, -- syntax limit (lines), 0=nolimit
syntax_limit_b = 1024*1024, -- syntax limit (bytes), 0=nolimit
expand = false, -- preview max size?
hl_cursor = 'Cursor', -- cursor highlight
hl_cursorline = 'CursorLine', -- cursor line highlight
hl_range = 'IncSearch', -- ranger highlight (not yet in use)
keymap = {
toggle_full = '<F2>', -- toggle full screen
toggle_wrap = '<F3>', -- toggle line wrap
toggle_hide = '<F4>', -- toggle on/off (not yet in use)
page_up = '<S-up>', -- preview scroll up
page_down = '<S-down>', -- preview scroll down
page_reset = '<S-left>', -- reset scroll to orig pos
},
},
},
-- provider setup
files = {
-- previewer = "cat", -- uncomment to override previewer
prompt = 'Files ',
cmd = '', -- "find . -type f -printf '%P\n'",
git_icons = true, -- show git icons?
file_icons = true, -- show file icons?
color_icons = true, -- colorize file|git icons
actions = {
-- set bind to 'false' to disable
["default"] = actions.file_edit,
["ctrl-s"] = actions.file_split,
["ctrl-v"] = actions.file_vsplit,
["ctrl-t"] = actions.file_tabedit,
["alt-q"] = actions.file_sel_to_qf,
-- custom actions are available too
["ctrl-y"] = function(selected) print(selected[2]) end,
}
},
git = {
files = {
prompt = 'GitFiles ',
cmd = 'git ls-files --exclude-standard',
git_icons = true, -- show git icons?
file_icons = true, -- show file icons?
color_icons = true, -- colorize file|git icons
},
status = {
prompt = 'GitStatus ',
cmd = "git status -s",
previewer = "git_diff",
file_icons = true,
git_icons = true,
color_icons = true,
},
commits = {
prompt = 'Commits ',
cmd = "git log --pretty=oneline --abbrev-commit --color --reflog",
preview = "git show --pretty='%Cred%H%n%Cblue%an%n%Cgreen%s' --color {1}",
actions = {
["default"] = actions.git_checkout,
},
},
bcommits = {
prompt = 'BCommits ',
cmd = "git log --pretty=oneline --abbrev-commit --color --reflog",
preview = "git show --pretty='%Cred%H%n%Cblue%an%n%Cgreen%s' --color {1}",
actions = {
["default"] = actions.git_buf_edit,
["ctrl-s"] = actions.git_buf_split,
["ctrl-v"] = actions.git_buf_vsplit,
["ctrl-t"] = actions.git_buf_tabedit,
},
},
branches = {
prompt = 'Branches ',
cmd = "git branch --all --color",
preview = "git log --graph --pretty=oneline --abbrev-commit --color {1}",
actions = {
["default"] = actions.git_switch,
},
},
icons = {
["M"] = { icon = "M", color = "yellow" },
["D"] = { icon = "D", color = "red" },
["A"] = { icon = "A", color = "green" },
["?"] = { icon = "?", color = "magenta" },
-- ["M"] = { icon = "★", color = "red" },
-- ["D"] = { icon = "✗", color = "red" },
-- ["A"] = { icon = "+", color = "green" },
},
},
grep = {
prompt = 'Rg ',
input_prompt = 'Grep For ',
-- cmd = "rg --vimgrep",
rg_opts = "--hidden --column --line-number --no-heading " ..
"--color=always --smart-case -g '!{.git,node_modules}/*'",
git_icons = true, -- show git icons?
file_icons = true, -- show file icons?
color_icons = true, -- colorize file|git icons
},
oldfiles = {
prompt = 'History ',
cwd_only = false,
},
buffers = {
-- previewer = false, -- disable the builtin previewer?
prompt = 'Buffers ',
file_icons = true, -- show file icons?
color_icons = true, -- colorize file|git icons
sort_lastused = true, -- sort buffers() by last used
actions = {
["default"] = actions.buf_edit,
["ctrl-s"] = actions.buf_split,
["ctrl-v"] = actions.buf_vsplit,
["ctrl-t"] = actions.buf_tabedit,
["ctrl-x"] = actions.buf_del,
}
},
blines = {
previewer = "builtin", -- set to 'false' to disable
prompt = 'BLines ',
actions = {
["default"] = actions.buf_edit,
["ctrl-s"] = actions.buf_split,
["ctrl-v"] = actions.buf_vsplit,
["ctrl-t"] = actions.buf_tabedit,
}
},
colorschemes = {
prompt = 'Colorschemes ',
live_preview = true, -- apply the colorscheme on preview?
actions = {
["default"] = actions.colorscheme,
["ctrl-y"] = function(selected) print(selected[2]) end,
},
winopts = {
win_height = 0.55,
win_width = 0.30,
},
post_reset_cb = function()
-- reset statusline highlights after
-- a live_preview of the colorscheme
-- require('feline').reset_highlights()
end,
},
quickfix = {
-- cwd = vim.loop.cwd(),
file_icons = true,
git_icons = true,
},
lsp = {
prompt = ' ',
-- cwd = vim.loop.cwd(),
cwd_only = false, -- LSP/diagnostics for cwd only?
async_or_timeout = true, -- timeout(ms) or false for blocking calls
file_icons = true,
git_icons = false,
lsp_icons = true,
severity = "hint",
icons = {
["Error"] = { icon = "", color = "red" }, -- error
["Warning"] = { icon = "", color = "yellow" }, -- warning
["Information"] = { icon = "", color = "blue" }, -- info
["Hint"] = { icon = "", color = "magenta" }, -- hint
},
},
-- uncomment to disable the previewer
-- nvim = { marks = { previewer = { _ctor = false } } },
-- helptags = { previewer = { _ctor = false } },
-- manpages = { previewer = { _ctor = false } },
-- uncomment to set dummy win location (help|man bar)
-- "topleft" : up
-- "botright" : down
-- helptags = { previewer = { split = "topleft" } },
-- manpages = { previewer = { split = "topleft" } },
-- uncomment to use `man` command as native fzf previewer
-- manpages = { previewer = { _ctor = require'fzf-lua.previewer'.fzf.man_pages } },
-- optional override of file extension icon colors
-- available colors (terminal):
-- clear, bold, black, red, green, yellow
-- blue, magenta, cyan, grey, dark_grey, white
-- padding can help kitty term users with
-- double-width icon rendering
file_icon_padding = '',
file_icon_colors = {
["lua"] = "blue",
},
}
<
This can also be run from a .vim file using:
>
lua << EOF
require('fzf-lua').setup{
-- ...
}
EOF
<
------------------------------------------------------------------------------
CREDITS *fzf-lua-credits*
Big thank you to all those I borrowed code/ideas from, I read so many configs
and plugin codes that I probably forgot where I found some samples from so if I
missed your name feel free to contact me and I'll add it below:
- @vijaymarupudi <https://github.com/vijaymarupudi/> for his wonderful
nvim-fzf <https://github.com/vijaymarupudi/nvim-fzf> plugin which is in the
core of this plugin
- @tjdevries <https://github.com/tjdevries/> for too many great things to
list here and for borrowing some of his
nvim-telescope <https://github.com/nvim-telescope/telescope.nvim> provider
code
- @lukas-reineke <https://github.com/lukas-reineke> for inspiring the
solution after browsing his
dotfiles <https://github.com/lukas-reineke/dotfiles> and coming across his
fuzzy.lua <https://github.com/lukas-reineke/dotfiles/blob/master/vim/lua/fuzzy.lua>
, and while we're, also here for his great lua plugin
indent-blankline <https://github.com/lukas-reineke/indent-blankline.nvim>
- @sindrets <https://github.com/sindrets> for borrowing utilities from his
fantastic lua plugin diffview.nvim <https://github.com/sindrets/diffview.nvim>
- @kevinhwang91 <https://github.com/kevinhwang91> for using his previewer
code as baseline for the builtin previewer and his must have plugin
nvim-bqf <https://github.com/kevinhwang91/nvim-bqf>
vim:tw=78:ts=8:ft=help:norl:
Loading…
Cancel
Save