Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucc/nvimpager
Use nvim as a pager to view manpages, diffs, etc with nvim's syntax highlighting
https://github.com/lucc/nvimpager
neovim nvim pager vimpager
Last synced: about 1 month ago
JSON representation
Use nvim as a pager to view manpages, diffs, etc with nvim's syntax highlighting
- Host: GitHub
- URL: https://github.com/lucc/nvimpager
- Owner: lucc
- License: other
- Created: 2017-10-23T14:03:17.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2024-09-15T21:45:08.000Z (2 months ago)
- Last Synced: 2024-09-27T18:22:02.557Z (about 2 months ago)
- Topics: neovim, nvim, pager, vimpager
- Language: Lua
- Homepage:
- Size: 378 KB
- Stars: 385
- Watchers: 7
- Forks: 21
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nvimpager
Using [neovim] as a pager to view man pages, git diffs, whatnot with neovim's
syntax highlighting and mouse support.
## About
The `nvimpager` script calls neovim in a fashion that turns it into something
like a pager. The idea is not new, this is actually rewrite of [vimpager] but
with less (but stricter) dependencies and specifically for neovim.
Some typical use cases:
```sh
# view a file in nvimpager
nvimpager file
# pipe text to nvimpager
echo some text | nvimpager
# use it as your default $PAGER
export PAGER=nvimpager
man bash
git diff
```
The script also has a "cat mode" which will not start up the neovim interface
but instead print a highlighted version of the file to the terminal. Like cat
with neovim syntax highlighting! If the input has less lines than the terminal
cat mode is activated automatically so nvimpager behaves similar to `less -F`.
Pager mode and cat mode can be enforced with the options `-p` and `-c`
respectively.
Nvimpager comes with a small set of command line options but you can also use
all of neovim's command line options. Use `nvimpager -h` to see the [help
text][options]. The configuration is separated from the users config for
neovim. The main config file is `~/.config/nvimpager/init.vim` (or `.lua`).
See [the manpage][configuration] for further explanation.
## Installation
Nvimpager is already packaged for some distributions. If not for yours, you can
install it manually, read on.
### Dependencies
* [neovim] ≥ v0.9.0
* [bash]
* [busted] (for running the tests)
* [scdoc] (to build the man page)
### Installation instructions
Use the makefile to configure and install the script. It supports the usual
`PREFIX` (defaults to `/usr/local`) and `DESTDIR` (defaults to empty)
variables:
```sh
make PREFIX=$HOME/.local install
```
The target `install-no-man` can be used to install nvimpager without the man
page.
Additionally the variable `BUSTED` can be used to specify the executable for
the test suite:
```sh
make test BUSTED="/path/to/busted --some-args"
```
## Development
Nvimpager is developed on [GitHub][nvimpager] where you are very much invited
to [post][issues] bug reports, feature or pull requests! The test can be run
with `make test`. They are also run on GitHub: [![Build Status]][ghactions]
### Limitations
* if reading from stdin, nvimpager (like nvim) waits for EOF until it starts up
* large files are slowing down neovim on startup (less does a better, i.e.
faster and more memory efficient job at paging large files)
### Ideas
* see how [neovim#5035], [neovim#7438] and [neovim#23093] are resolved and
maybe move more code (logic) from bash to lua (bash's `[[ -t ... ]]` can be
replaced by `has('ttyin')`, `has('ttyout')`)
* proper lazy pipe reading while paging (like less) to improve startup time and
also memory usage for large input on pipes (maybe `stdioopen()` can be used?)
## License
The project is licensed under a BSD-2-clause license. See the
[LICENSE](./LICENSE) file.
[nvimpager]: https://github.com/lucc/nvimpager
[issues]: https://github.com/lucc/nvimpager/issues
[options]: ./nvimpager.md#command-line-options
[configuration]: ./nvimpager.md#configuration
[neovim]: https://github.com/neovim/neovim
[vimpager]: https://github.com/rkitover/vimpager
[bash]: https://www.gnu.org/software/bash/bash.html
[busted]: https://lunarmodules.github.io/busted/
[scdoc]: https://git.sr.ht/~sircmpwn/scdoc
[Build Status]: https://github.com/lucc/nvimpager/actions/workflows/test.yml/badge.svg
[ghactions]: https://github.com/lucc/nvimpager/actions
[neovim#5035]: https://github.com/neovim/neovim/issues/5035 (detach / reattach)
[neovim#7438]: https://github.com/neovim/neovim/issues/7438 (dynamic --headless)
[neovim#23093]: https://github.com/neovim/neovim/issues/23093 (detach current tui)