README update, vimdoc generated using new treesitter markdown parser

main
bhagwan 2 years ago
parent 3717661c83
commit 2012d97260

@ -54,7 +54,7 @@ at it. That, **and colorful file icons and git indicators!**.
- [nvim-web-devicons](https://github.com/kyazdani42/nvim-web-devicons) - [nvim-web-devicons](https://github.com/kyazdani42/nvim-web-devicons)
(optional) (optional)
### Optional dependencies (recommended) ### Optional dependencies
- [fd](https://github.com/sharkdp/fd) - better `find` utility - [fd](https://github.com/sharkdp/fd) - better `find` utility
- [rg](https://github.com/BurntSushi/ripgrep) - better `grep` utility - [rg](https://github.com/BurntSushi/ripgrep) - better `grep` utility

@ -11,8 +11,8 @@ Customization <#customization> • Wiki
Demo <https://raw.githubusercontent.com/wiki/ibhagwan/fzf-lua/demo.gif> Demo <https://raw.githubusercontent.com/wiki/ibhagwan/fzf-lua/demo.gif>
fzf <https://github.com/junegunn/fzf> changed my life, it can change yours too, fzf <https://github.com/junegunn/fzf> changed my life, it can change yours
if you allow it. too, if you allow it.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
@ -23,9 +23,9 @@ 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 single most impactful tool for my command line workflow, once I started using
fzf I couldnt see myself living without it. fzf I couldnt see myself living without it.
To understand fzf properly I highly recommended fzf screencast **To understand fzf properly I highly recommended fzf screencast
<https://www.youtube.com/watch?v=qgG5Jhi_Els> by @samoshkin <https://www.youtube.com/watch?v=qgG5Jhi_Els> by @samoshkin
<https://github.com/samoshkin> <https://github.com/samoshkin>**
This is my take on the original fzf.vim <https://github.com/junegunn/fzf.vim>, 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 written in lua for neovim 0.5, it builds on the elegant nvim-fzf
@ -43,16 +43,16 @@ WHY FZF-LUA *fzf-lua-why-fzf-lua*
<https://github.com/liuchengxu/vim-clap>? <https://github.com/liuchengxu/vim-clap>?
As @junegunn <https://github.com/junegunn> himself put it, “because you can As @junegunn <https://github.com/junegunn> himself put it, “because you can
and you love fzf ”. and you love `fzf`”.
If youre happy with your current setup there is absolutely no reason to If youre happy with your current setup there is absolutely no reason to
switch. switch.
That said, without taking anything away from the greatness of other plugins I 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 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 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 hadnt failed me once, it never hangs and can handle almost anything you
throw at it. That, and colorful file icons and git indicators!. throw at it. That, **and colorful file icons and git indicators!**.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
@ -61,13 +61,13 @@ DEPENDENCIES *fzf-lua-dependencies*
- `Linux` or `MacOS` - `Linux` or `MacOS`
- `neovim` <https://github.com/neovim/neovim/releases> version > 0.5.0 - `neovim` <https://github.com/neovim/neovim/releases> version > 0.5.0
- `fzf` <https://github.com/junegunn/fzf> or - `fzf` <https://github.com/junegunn/fzf> or `skim`
`skim` <https://github.com/lotabout/skim> binary installed <https://github.com/lotabout/skim> binary installed
- nvim-web-devicons <https://github.com/kyazdani42/nvim-web-devicons> - nvim-web-devicons <https://github.com/kyazdani42/nvim-web-devicons>
(optional) (optional)
OPTIONAL DEPENDENCIES (RECOMMENDED)*fzf-lua-optional-dependencies-(recommended)* OPTIONAL DEPENDENCIES *fzf-lua-optional-dependencies*
- fd <https://github.com/sharkdp/fd> - better `find` utility - fd <https://github.com/sharkdp/fd> - better `find` utility
- rg <https://github.com/BurntSushi/ripgrep> - better `grep` utility - rg <https://github.com/BurntSushi/ripgrep> - better `grep` utility
@ -94,25 +94,24 @@ Using packer.nvim <https://github.com/wbthomason/packer.nvim>
requires = { 'kyazdani42/nvim-web-devicons' } requires = { 'kyazdani42/nvim-web-devicons' }
} }
< <
Note: if you already have fzf installed you do not need to install fzf or **Note:** if you already have fzf installed you do not need to install `fzf`
fzf.vim , however if you do not have it installed, you only need fzf which can or `fzf.vim`, however if you do not have it installed, **you only need** fzf
be installed with (fzf.vim is not a requirement nor conflict): which can be installed with (fzf.vim is not a requirement nor conflict):
> >
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } } Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
< <
or with packer.nvim <https://github.com/wbthomason/packer.nvim>: or with packer.nvim <https://github.com/wbthomason/packer.nvim>:
> >
use = { 'junegunn/fzf', run = './install --bin', } use = { 'junegunn/fzf', run = './install --bin', }
< <
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
USAGE *fzf-lua-usage* USAGE *fzf-lua-usage*
Fzf-lua aims to be as plug and play as possible with sane defaults, you can run Fzf-lua aims to be as plug and play as possible with sane defaults, you can
any fzf-lua command like this: run any fzf-lua command like this:
> >
:lua require('fzf-lua').files() :lua require('fzf-lua').files()
@ -131,7 +130,7 @@ which can be easily mapped to:
> >
nnoremap <c-P> <cmd>lua require('fzf-lua').files()<CR> nnoremap <c-P> <cmd>lua require('fzf-lua').files()<CR>
< <
or if using init.lua : or if using `init.lua`:
> >
vim.api.nvim_set_keymap('n', '<c-P>', vim.api.nvim_set_keymap('n', '<c-P>',
@ -159,6 +158,7 @@ BUFFERS AND FILES *fzf-lua-buffers-and-files*
| `tabs` | open tabs | | `tabs` | open tabs |
| `args` | argument list | | `args` | argument list |
SEARCH *fzf-lua-search* SEARCH *fzf-lua-search*
@ -177,6 +177,7 @@ SEARCH *fzf-lua-search*
| `live_grep_glob` | live_grep with `rg --glob` support | | `live_grep_glob` | live_grep with `rg --glob` support |
| `live_grep_native` | performant version of `live_grep` | | `live_grep_native` | performant version of `live_grep` |
GIT *fzf-lua-git* GIT *fzf-lua-git*
@ -188,6 +189,7 @@ GIT *fzf-lua-git*
| `git_bcommits` | git commit log (buffer) | | `git_bcommits` | git commit log (buffer) |
| `git_branches` | git branches | | `git_branches` | git branches |
LSP *fzf-lua-lsp* LSP *fzf-lua-lsp*
@ -205,6 +207,7 @@ LSP *fzf-lua-lsp*
| `lsp_document_diagnostics` | Document Diagnostics | | `lsp_document_diagnostics` | Document Diagnostics |
| `lsp_workspace_diagnostics` | Workspace Diagnostics | | `lsp_workspace_diagnostics` | Workspace Diagnostics |
MISC *fzf-lua-misc* MISC *fzf-lua-misc*
@ -229,6 +232,7 @@ MISC *fzf-lua-misc*
| `filetypes` | neovim filetypes | | `filetypes` | neovim filetypes |
| `packadd` | :packadd <package> | | `packadd` | :packadd <package> |
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
CUSTOMIZATION *fzf-lua-customization* CUSTOMIZATION *fzf-lua-customization*
@ -236,8 +240,8 @@ CUSTOMIZATION *fzf-lua-customization*
I tried to make it as customizable as possible, if you find you need to change 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. 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 customization can be achieved by calling the `setup()` function or
sending parameters to a builtin command, for exmaple: individually sending parameters to a builtin command, for exmaple:
> >
:lua require('fzf-lua').files({ fzf_opts = {['--layout'] = 'reverse-list'} }) :lua require('fzf-lua').files({ fzf_opts = {['--layout'] = 'reverse-list'} })
@ -654,7 +658,7 @@ Consult the list below for available settings:
}, },
} }
< <
This can also be run from a .vim file using: This can also be run from a `.vim` file using:
> >
lua << EOF lua << EOF
@ -669,26 +673,26 @@ CREDITS *fzf-lua-credits*
Big thank you to all those I borrowed code/ideas from, I read so many configs 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 and plugin codes that I probably forgot where I found some samples from so if
missed your name feel free to contact me and I'll add it below: I missed your name feel free to contact me and I'll add it below:
- @vijaymarupudi <https://github.com/vijaymarupudi/> for his wonderful - @vijaymarupudi <https://github.com/vijaymarupudi/> for his wonderful
nvim-fzf <https://github.com/vijaymarupudi/nvim-fzf> plugin which is in the nvim-fzf <https://github.com/vijaymarupudi/nvim-fzf> plugin which is in the
core of this plugin core of this plugin
- @tjdevries <https://github.com/tjdevries/> for too many great things to - @tjdevries <https://github.com/tjdevries/> for too many great things to list
list here and for borrowing some of his here and for borrowing some of his nvim-telescope
nvim-telescope <https://github.com/nvim-telescope/telescope.nvim> provider <https://github.com/nvim-telescope/telescope.nvim> provider code
code - @lukas-reineke <https://github.com/lukas-reineke> for inspiring the solution
- @lukas-reineke <https://github.com/lukas-reineke> for inspiring the after browsing his dotfiles <https://github.com/lukas-reineke/dotfiles> and
solution after browsing his coming across his fuzzy.lua
dotfiles <https://github.com/lukas-reineke/dotfiles> and coming across his <https://github.com/lukas-reineke/dotfiles/blob/master/vim/lua/fuzzy.lua> ,
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
, and while we're, also here for his great lua plugin <https://github.com/lukas-reineke/indent-blankline.nvim>
indent-blankline <https://github.com/lukas-reineke/indent-blankline.nvim>
- @sindrets <https://github.com/sindrets> for borrowing utilities from his - @sindrets <https://github.com/sindrets> for borrowing utilities from his
fantastic lua plugin diffview.nvim <https://github.com/sindrets/diffview.nvim> fantastic lua plugin diffview.nvim
- @kevinhwang91 <https://github.com/kevinhwang91> for using his previewer <https://github.com/sindrets/diffview.nvim>
code as baseline for the builtin previewer and his must have plugin - @kevinhwang91 <https://github.com/kevinhwang91> for using his previewer code
nvim-bqf <https://github.com/kevinhwang91/nvim-bqf> 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: vim:tw=78:ts=8:ft=help:norl:
Loading…
Cancel
Save