mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2024-12-12 20:21:02 +01:00
Marc Cornellà
parent
fd786291ba
commit
587b554580
7 changed files with 352 additions and 107 deletions
|
|
@ -27,7 +27,7 @@ GPLv3 License
|
||||||
GNU GENERAL PUBLIC LICENSE
|
GNU GENERAL PUBLIC LICENSE
|
||||||
Version 3, 29 June 2007
|
Version 3, 29 June 2007
|
||||||
|
|
||||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||||
Everyone is permitted to copy and distribute verbatim copies
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
of this license document, but changing it is not allowed.
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
|
@ -671,7 +671,7 @@ the "copyright" line and a pointer to where the full notice is found.
|
||||||
GNU General Public License for more details.
|
GNU General Public License for more details.
|
||||||
|
|
||||||
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
||||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
Also add information on how to contact you by electronic and paper mail.
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
|
@ -690,11 +690,11 @@ might be different; for a GUI interface, you would use an "about box".
|
||||||
You should also get your employer (if you work as a programmer) or school,
|
You should also get your employer (if you work as a programmer) or school,
|
||||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||||
For more information on this, and how to apply and follow the GNU GPL, see
|
For more information on this, and how to apply and follow the GNU GPL, see
|
||||||
<https://www.gnu.org/licenses/>.
|
<http://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
The GNU General Public License does not permit incorporating your program
|
The GNU General Public License does not permit incorporating your program
|
||||||
into proprietary programs. If your program is a subroutine library, you
|
into proprietary programs. If your program is a subroutine library, you
|
||||||
may consider it more useful to permit linking proprietary applications with
|
may consider it more useful to permit linking proprietary applications with
|
||||||
the library. If this is what you want to do, use the GNU Lesser General
|
the library. If this is what you want to do, use the GNU Lesser General
|
||||||
Public License instead of this License. But first, please read
|
Public License instead of this License. But first, please read
|
||||||
<https://www.gnu.org/philosophy/why-not-lgpl.html>.
|
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||||
|
|
|
||||||
35
plugins/zsh-navigation-tools/Makefile
Normal file
35
plugins/zsh-navigation-tools/Makefile
Normal file
|
|
@ -0,0 +1,35 @@
|
||||||
|
NAME=zsh-navigation-tools
|
||||||
|
|
||||||
|
INSTALL?=install -c
|
||||||
|
PREFIX?=/usr/local
|
||||||
|
SHARE_DIR?=$(DESTDIR)$(PREFIX)/share/$(NAME)
|
||||||
|
DOC_DIR?=$(DESTDIR)$(PREFIX)/share/doc/$(NAME)
|
||||||
|
|
||||||
|
all:
|
||||||
|
|
||||||
|
install:
|
||||||
|
$(INSTALL) -d $(SHARE_DIR)
|
||||||
|
$(INSTALL) -d $(SHARE_DIR)/.config
|
||||||
|
$(INSTALL) -d $(SHARE_DIR)/.config/znt
|
||||||
|
$(INSTALL) -d $(DOC_DIR)
|
||||||
|
cp zsh-navigation-tools.plugin.zsh _n-kill doc/znt-tmux.zsh $(SHARE_DIR)
|
||||||
|
cp README.md NEWS LICENSE doc/img/n-history2.png $(DOC_DIR)
|
||||||
|
if [ x"true" = x"`git rev-parse --is-inside-work-tree 2>/dev/null`" ]; then \
|
||||||
|
git rev-parse HEAD; \
|
||||||
|
else \
|
||||||
|
cat .revision-hash; \
|
||||||
|
fi > $(SHARE_DIR)/.revision-hash
|
||||||
|
:
|
||||||
|
for fname in n-*; do cp "$$fname" $(SHARE_DIR); done; \
|
||||||
|
for fname in znt-*; do cp "$$fname" $(SHARE_DIR); done; \
|
||||||
|
for fname in .config/znt/n-*; do cp "$$fname" $(SHARE_DIR)/.config/znt; done;
|
||||||
|
|
||||||
|
uninstall:
|
||||||
|
rm -f $(SHARE_DIR)/.revision-hash $(SHARE_DIR)/_* $(SHARE_DIR)/zsh-* $(SHARE_DIR)/n-* $(SHARE_DIR)/znt-* $(SHARE_DIR)/.config/znt/n-*
|
||||||
|
[ -d $(SHARE_DIR)/.config/znt ] && rmdir $(SHARE_DIR)/.config/znt || true
|
||||||
|
[ -d $(SHARE_DIR)/.config ] && rmdir $(SHARE_DIR)/.config || true
|
||||||
|
[ -d $(SHARE_DIR) ] && rmdir $(SHARE_DIR) || true
|
||||||
|
rm -f $(DOC_DIR)/README.md $(DOC_DIR)/LICENSE $(DOC_DIR)/n-history2.png
|
||||||
|
[ -d $(DOC_DIR) ] && rmdir $(DOC_DIR) || true
|
||||||
|
|
||||||
|
.PHONY: all install uninstall
|
||||||
|
|
@ -1,58 +1,68 @@
|
||||||
|
[](./LICENSE)
|
||||||
|
[](./LICENSE)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=D6XDCHDSBDSDG)
|
||||||
|
|
||||||
# Zsh Navigation Tools
|
# Zsh Navigation Tools
|
||||||
|
|
||||||
https://raw.githubusercontent.com/psprint/zsh-navigation-tools/master/doc/img/n-history2.png
|
Also check out [ Zsh Command Architect](https://github.com/psprint/zsh-cmd-architect)
|
||||||
|
and [Zconvey](https://github.com/psprint/zconvey)
|
||||||
|
|
||||||
Set of tools like n-history – multi-word history searcher, n-cd – directory
|
|
||||||
bookmark manager, n-kill – htop like kill utility, and more. Based on
|
|
||||||
n-list, a tool generating selectable curses-based list of elements that has
|
|
||||||
access to current Zsh session, i.e. has broad capabilities to work together
|
|
||||||
with it. Feature highlights include incremental multi-word searching, ANSI
|
|
||||||
coloring, unique mode, horizontal scroll, non-selectable elements, grepping and
|
|
||||||
various integrations with Zsh.
|
|
||||||
|
|
||||||
## History Widget
|
|
||||||
|
|
||||||
To have n-history as multi-word incremental searcher bound to Ctrl-R copy znt-*
|
Videos:
|
||||||
files into the */site-functions dir (unless you use Oh My Zsh) and
|
- [https://youtu.be/QwZ8IJEgXRE](https://youtu.be/QwZ8IJEgXRE)
|
||||||
add:
|
- [https://youtu.be/DN9QqssAYB8](https://youtu.be/DN9QqssAYB8)
|
||||||
|
|
||||||
autoload znt-history-widget
|
Screenshots:
|
||||||
zle -N znt-history-widget
|
|
||||||
bindkey "^R" znt-history-widget
|
|
||||||
|
|
||||||
to .zshrc. This is done automatically when using Oh My Zsh. Two other
|
|
||||||
widgets exist, znt-cd-widget and znt-kill-widget, they can be too assigned
|
|
||||||
to key combinations (no need for autoload when using Oh My Zsh):
|
|
||||||
|
|
||||||
zle -N znt-cd-widget
|
|
||||||
bindkey "^A" znt-cd-widget
|
|
||||||
zle -N znt-kill-widget
|
|
||||||
bindkey "^Y" znt-kill-widget
|
|
||||||
|
|
||||||
Oh My Zsh stores history into ~/.zsh_history. When you switch to OMZ you could
|
Set of tools like `n-history` – multi-word history searcher, `n-cd` – directory
|
||||||
want to copy your previous data (from e.g. ~/.zhistory) into the new location.
|
bookmark manager, `n-kill` – `htop` like kill utility, and more. Based on
|
||||||
|
`n-list`, a tool generating selectable curses-based list of elements that has
|
||||||
|
access to current `Zsh` session, i.e. has broad capabilities to work together
|
||||||
|
with it. Feature highlights include incremental multi-word searching, approximate
|
||||||
|
matching, ANSI coloring, themes, unique mode, horizontal scroll, grepping, advanced
|
||||||
|
history management and various integrations with `Zsh`.
|
||||||
|
|
||||||
## News
|
## News
|
||||||
|
|
||||||
* 06-10-2016
|
* 06-10-2016
|
||||||
- Tmux-integration – Ctrl-b-h in Tmux to open n-history in new window.
|
- **Tmux-integration** – `Ctrl-B H` in Tmux to open `n-history` in new window.
|
||||||
Then select history entry, it will be copied to the original Tmux window.
|
Then select history entry, it will be copied to the original Tmux window.
|
||||||
Use this to execute local commands on remote hosts. All that is needed is
|
Use this to execute local commands on remote hosts:
|
||||||
this line added to ~/.tmux.conf:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
All that is needed is this line added to `~/.tmux.conf`:
|
||||||
|
|
||||||
|
```
|
||||||
|
bind h run-shell -b "$ZNT_REPO_DIR/doc/znt-tmux.zsh"
|
||||||
|
```
|
||||||
|
|
||||||
|
or – if Homebrew or other package manager is used:
|
||||||
|
|
||||||
|
```
|
||||||
bind h run-shell -b "$ZNT_REPO_DIR/znt-tmux.zsh"
|
bind h run-shell -b "$ZNT_REPO_DIR/znt-tmux.zsh"
|
||||||
|
```
|
||||||
|
|
||||||
* 16-05-2016
|
* 16-05-2016
|
||||||
- n-kill has completion. It proposes *words* from what's in `ps -A`. Giving n-kill
|
- `n-kill` has completion. It proposes **words** from what's in `ps -A`. Giving `n-kill`
|
||||||
arguments means grepping – it will start only with matching `ps` entries.
|
arguments means grepping – it will start only with matching `ps` entries.
|
||||||
|
|
||||||
* 15-05-2016
|
* 15-05-2016
|
||||||
- Fixed problem where zsh-syntax-highlighting could render n-history slow (for
|
- Fixed problem where zsh-syntax-highlighting could render `n-history` slow (for
|
||||||
long history entries).
|
long history entries).
|
||||||
|
|
||||||
* 14-05-2016
|
* 14-05-2016
|
||||||
- Configuration can be set from zshrc. Example:
|
- Configuration can be set from `zshrc` (starting from `v2.1.12`). Documentation is [below](#configuration). Example:
|
||||||
|
|
||||||
|
```zsh
|
||||||
znt_list_instant_select=1
|
znt_list_instant_select=1
|
||||||
znt_list_border=0
|
znt_list_border=0
|
||||||
znt_list_bold=1
|
znt_list_bold=1
|
||||||
|
|
@ -63,76 +73,197 @@ want to copy your previous data (from e.g. ~/.zhistory) into the new location.
|
||||||
znt_cd_hotlist=( "~/.config/znt" "/usr/share/zsh/site-functions" "/usr/share/zsh"
|
znt_cd_hotlist=( "~/.config/znt" "/usr/share/zsh/site-functions" "/usr/share/zsh"
|
||||||
"/usr/local/share/zsh/site-functions" "/usr/local/share/zsh"
|
"/usr/local/share/zsh/site-functions" "/usr/local/share/zsh"
|
||||||
"/usr/local/bin" )
|
"/usr/local/bin" )
|
||||||
|
```
|
||||||
|
|
||||||
* 10-05-2016
|
* 10-05-2016
|
||||||
- Search query rotation – use Ctrl-A to rotate entered words right.
|
- Search query rotation – use `Ctrl-A` to rotate entered words right.
|
||||||
Words `1 2 3` become `3 1 2`.
|
Words `1 2 3` become `3 1 2`.
|
||||||
|
|
||||||
* 09-05-2016
|
* 09-05-2016
|
||||||
- New feature: n-help tool, available also from n-history via H key. It
|
- New feature: n-help tool, available also from n-history via `H` key. It
|
||||||
displays help screen with various information on ZNT.
|
displays help screen with various information on `ZNT`.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* 08-05-2016
|
* 08-05-2016
|
||||||
- Approximate matching – pressing f or Ctrl-F will enter FIX mode, in
|
- Approximate matching – pressing `f` or `Ctrl-F` will enter "`FIX`" mode,
|
||||||
which 1 or 2 errors are allowed in what is searched. This utilizes
|
in which `1` or `2` errors are allowed in what's searched. This utilizes
|
||||||
original Zsh approximate matching features and is intended to be used
|
original Zsh approximate matching features and is intended to be used
|
||||||
after entering search query, when a typo is discovered.
|
after entering search query, when a typo is discovered.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* 06-05-2016
|
* 06-05-2016
|
||||||
- Private history can be edited. Use e key or Ctrl-E for that when in
|
- Private history can be edited. Use `e` key or `Ctrl-E` for that when in
|
||||||
n-history. Your $EDITOR will start. This is a way to have handy set
|
n-history. Your `$EDITOR` will start. This is a way to have handy set of
|
||||||
of bookmarks prepared in private history's file.
|
bookmarks prepared in private history's file.
|
||||||
- Border can be disabled. Use following snippet in ~/.config/znt/n-list.conf
|
- Border can be disabled. Use following snippet in `~/.config/znt/n-list.conf`
|
||||||
or any other tool-targetted config file:
|
or any other tool-targetted config file:
|
||||||
|
|
||||||
|
```zsh
|
||||||
# Should draw the border?
|
# Should draw the border?
|
||||||
local border=0
|
local border=0
|
||||||
|
```
|
||||||
|
|
||||||
* 30-04-2016
|
* 30-04-2016
|
||||||
- New feature: color themes. Use Ctrl-T and Ctrl-G to browse predefined
|
- New feature: color themes. Use `Ctrl-T` and `Ctrl-G` to browse predefined
|
||||||
themes. They are listed in ~/.config/znt/n-list.conf. Use the file to
|
themes. They are listed in [~/.config/znt/n-list.conf](https://github.com/psprint/zsh-navigation-tools/blob/master/.config/znt/n-list.conf).
|
||||||
permanently set a color scheme. Also, I sent a patch to Zsh developers
|
Use the file to permanently set a color scheme. Also, I sent a patch to Zsh developers
|
||||||
and starting from Zsh > 5.2 (not yet released) supported will be 256 colors.
|
and starting from Zsh > 5.2 (not yet released) supported will be 256 colors.
|
||||||
The file ~/.config/znt/n-list.conf already has set of 256-color themes prepared :)
|
The file [~/.config/znt/n-list.conf](https://github.com/psprint/zsh-navigation-tools/blob/master/.config/znt/n-list.conf)
|
||||||
|
already has set of 256-color themes prepared :)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
* 29-04-2016
|
* 29-04-2016
|
||||||
- New feature: private history – n-history tracks selected history entries,
|
- New feature: private history – n-history tracks selected history entries,
|
||||||
exposes them via new view (activated with F1)
|
exposes them via new view (activated with `F1`). It is shared across all
|
||||||
|
sessions
|
||||||
|
|
||||||
* 28-04-2016
|
* 28-04-2016
|
||||||
- New features:
|
- New features:
|
||||||
1. New n-history view (activated with F1): Most Frequent History Words
|
1. New n-history view (activated with `F1`): Most Frequent History Words
|
||||||
2. Predefined search keywords – use F2 to quickly search for chosen
|
2. Predefined search keywords – use F2 to quickly search for chosen
|
||||||
keywords (video: [https://youtu.be/DN9QqssAYB8](https://youtu.be/DN9QqssAYB8))
|
keywords (video: [https://youtu.be/DN9QqssAYB8](https://youtu.be/DN9QqssAYB8))
|
||||||
3. Configuration option for doing instant selection in search mode
|
3. Configuration option for doing instant selection in search mode
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```
|
||||||
|
sh -c "$(curl -fsSL https://raw.githubusercontent.com/psprint/zsh-navigation-tools/master/doc/install.sh)"
|
||||||
|
```
|
||||||
|
|
||||||
|
To update run the command again.
|
||||||
|
|
||||||
|
`ZNT` will be installed at `~/.config/znt/zsh-navigation-tools`, config files will be copied to `~/.config/znt`. `.zshrc`
|
||||||
|
will be updated with only `8` lines of code, which will be added at the bottom.
|
||||||
|
|
||||||
|
After installing and reloading shell give `ZNT` a quick try with `Ctrl-R` – this keyboard shortcut will open `n-history`.
|
||||||
|
|
||||||
|
## Installation With [Zplugin](https://github.com/psprint/zplugin)
|
||||||
|
Add `zplugin load psprint/zsh-navigation-tools` to `.zshrc`. The config files will be in `~/.config/znt`.
|
||||||
|
|
||||||
|
## Installation With Zgen
|
||||||
|
|
||||||
|
Add `zgen load psprint/zsh-navigation-tools` to `.zshrc` and issue a `zgen reset` (this assumes that there is a proper `zgen save` construct in `.zshrc`).
|
||||||
|
The config files will be available in `~/.config/znt`.
|
||||||
|
|
||||||
|
## Installation With Antigen
|
||||||
|
Add `antigen bundle psprint/zsh-navigation-tools` to `.zshrc`. There also
|
||||||
|
should be `antigen apply`. The config files will be in `~/.config/znt`.
|
||||||
|
|
||||||
|
## Single File Manual Installation
|
||||||
|
|
||||||
|
Running script `doc/generate_single_file` will create single-file version of `ZNT`.
|
||||||
|
It can be sourced from `.zshrc`. Don't forget about configuration files as described
|
||||||
|
above.
|
||||||
|
|
||||||
|
## Manual Installation
|
||||||
|
|
||||||
|
After extracting `ZNT` to `{some-directory}` add following two lines
|
||||||
|
to `~/.zshrc`:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
fpath+=( {some-directory} )
|
||||||
|
source "{some-directory}/zsh-navigation-tools.plugin.zsh"
|
||||||
|
```
|
||||||
|
|
||||||
|
As you can see, no plugin manager is needed to use the `*.plugin.zsh`
|
||||||
|
file. The above two lines of code are all that almost **all** plugin
|
||||||
|
managers do. In fact, what's actually needed is only:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
source "{some-directory}/zsh-navigation-tools.plugin.zsh"
|
||||||
|
```
|
||||||
|
|
||||||
|
because `ZNT` detects if it is used by **any** plugin manager and can
|
||||||
|
handle `$fpath` update by itself.
|
||||||
|
|
||||||
|
## Truly Manual Installation
|
||||||
|
Copy (or link) all `n-*` and `znt-*` files to **/usr/share/zsh/site-functions/**
|
||||||
|
(or **/usr/local/share/zsh/site-functions/**, check with `echo $fpath[1]`) and then add:
|
||||||
|
|
||||||
|
autoload n-list n-cd n-env n-kill n-panelize n-options n-aliases n-functions n-history n-help
|
||||||
|
|
||||||
|
to `~/.zshrc`.
|
||||||
|
|
||||||
|
Create aliases to avoid typing of the minus sign "-":
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
alias naliases=n-aliases ncd=n-cd nenv=n-env nfunctions=n-functions nhistory=n-history
|
||||||
|
alias nkill=n-kill noptions=n-options npanelize=n-panelize nhelp=n-help
|
||||||
|
```
|
||||||
|
|
||||||
|
Don't forget to copy [configuration files](https://github.com/psprint/zsh-navigation-tools/tree/master/.config/znt). They should go to `~/.config/znt`. Moreover, `n-cd` works together with option `AUTO_PUSHD` and you should have:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
setopt AUTO_PUSHD
|
||||||
|
```
|
||||||
|
|
||||||
|
in `.zshrc` (also recommend `PUSHD_IGNORE_DUPS`). Without the option `n-cd`
|
||||||
|
will just work as incremental searcher of directory bookmarks.
|
||||||
|
|
||||||
|
## History Widget
|
||||||
|
|
||||||
|
To have `n-history` as the incremental searcher bound to `Ctrl-R` copy `znt-*`
|
||||||
|
files into the `*/site-functions` dir (unless you do single file install) and
|
||||||
|
add:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
autoload znt-history-widget
|
||||||
|
zle -N znt-history-widget
|
||||||
|
bindkey "^R" znt-history-widget
|
||||||
|
```
|
||||||
|
|
||||||
|
to `.zshrc`. This is done automatically when using the installer, zgen, antigen
|
||||||
|
or single file install. Two other widgets exist, `znt-cd-widget` and
|
||||||
|
`znt-kill-widget`, they too can be assigned to key combinations (`autoload` is done
|
||||||
|
in `.zshrc` so no need of it):
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
zle -N znt-cd-widget
|
||||||
|
bindkey "^B" znt-cd-widget
|
||||||
|
zle -N znt-kill-widget
|
||||||
|
bindkey "^Y" znt-kill-widget
|
||||||
|
```
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
The tools are:
|
The tools are:
|
||||||
|
|
||||||
- n-aliases - browses aliases, relegates editing to vared
|
- `n-aliases` - browses aliases, relegates editing to `vared`
|
||||||
- n-cd - browses dirstack and bookmarked directories, allows to enter selected directory
|
- `n-cd` - browses dirstack and bookmarked directories, allows to enter selected directory
|
||||||
- n-functions - browses functions, relegates editing to zed or vared
|
- `n-functions` - browses functions, relegates editing to `zed` or `vared`
|
||||||
- n-history - browses history, allows to edit and run commands from it
|
- `n-history` - browses history, allows to edit and run commands from it
|
||||||
- n-kill - browses processes list, allows to send signal to selected process
|
- `n-kill` - browses processes list, allows to send signal to selected process
|
||||||
- n-env - browses environment, relegates editing to vared
|
- `n-env` - browses environment, relegates editing to `vared`
|
||||||
- n-options - browses options, allows to toggle their state
|
- `n-options` - browses options, allows to toggle their state
|
||||||
- n-panelize - loads output of given command into the list for browsing
|
- `n-panelize` - loads output of given command into the list for browsing
|
||||||
|
|
||||||
All tools support horizontal scroll with <,>, {,}, h,l or left and right
|
All tools support horizontal scroll with `<`,`>`, `{`,`}`, `h`,`l` or left and right cursors. Other keys are:
|
||||||
cursors. Other keys are:
|
|
||||||
|
|
||||||
- [,] - jump directory bookmarks in n-cd and typical signals in n-kill
|
- `H`, `?` (from n-history) - run n-help
|
||||||
- Ctrl-d, Ctrl-u - half page up or down
|
- `Ctrl-R` - start n-history, the incremental, multi-keyword history searcher (Zsh binding)
|
||||||
- Ctrl-p, Ctrl-n - previous and next (also done with vim's j,k)
|
- `Ctrl-A` - rotate entered words (1+2+3 -> 3+1+2)
|
||||||
- Ctrl-l - redraw of whole display
|
- `Ctrl-F` - fix mode (approximate matching)
|
||||||
- g, G - beginning and end of the list
|
- `Ctrl-L` - redraw of whole display
|
||||||
- Ctrl-o, o - enter uniq mode (no duplicate lines)
|
- `Ctrl-T` - browse themes (next theme)
|
||||||
- / - start incremental search
|
- `Ctrl-G` - browse themes (previous theme)
|
||||||
- Enter - finish incremental search, retaining filter
|
- `Ctrl-U` - half page up
|
||||||
- Esc - exit incremental search, clearing filter
|
- `Ctrl-D` - half page down
|
||||||
- Ctrl-w (in incremental search) - delete whole word
|
- `Ctrl-P` - previous element (also done with vim's k)
|
||||||
- Ctrl-k (in incremental search) - delete whole line
|
- `Ctrl-N` - next element (also done with vim's j)
|
||||||
|
- `[`, `]` - jump directory bookmarks in n-cd and typical signals in n-kill
|
||||||
|
- `g`, `G` - beginning and end of the list
|
||||||
|
- `/` - show incremental search
|
||||||
|
- `F3` - show/hide incremental search
|
||||||
|
- `Esc` - exit incremental search, clearing filter
|
||||||
|
- `Ctrl-W` (in incremental search) - delete whole word
|
||||||
|
- `Ctrl-K` (in incremental search) - delete whole line
|
||||||
|
- `Ctrl-O`, `o` - enter uniq mode (no duplicate lines)
|
||||||
|
- `Ctrl-E`, `e` - edit private history (when in private history view)
|
||||||
|
- `F1` - (in n-history) - switch view
|
||||||
|
- `F2`, `Ctrl-X`, `Ctrl-/` - search predefined keywords (defined in config files)
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
|
|
@ -177,7 +308,7 @@ znt_history_active_text - underline or reverse - how should be active element hi
|
||||||
znt_history_nlist_coloring_pattern - pattern that can be used to colorize elements
|
znt_history_nlist_coloring_pattern - pattern that can be used to colorize elements
|
||||||
znt_history_nlist_coloring_color - color with which to colorize
|
znt_history_nlist_coloring_color - color with which to colorize
|
||||||
znt_history_nlist_coloring_match_multiple - should multiple matches be colorized (0 or 1)
|
znt_history_nlist_coloring_match_multiple - should multiple matches be colorized (0 or 1)
|
||||||
znt_history_keywords (array) - search keywords activated with `Ctrl-X`
|
znt_history_keywords (array) - search keywords activated with `Ctrl-X`, `F2` or `Ctrl-/`, e.g. ( "git" "vim" )
|
||||||
```
|
```
|
||||||
|
|
||||||
Above variables will work for `n-history` tool. For other tools, change `_history_` to
|
Above variables will work for `n-history` tool. For other tools, change `_history_` to
|
||||||
|
|
@ -193,52 +324,108 @@ znt_list_themes (array) - list of themes to try out with Ctrl-T, e.g. ( "white/b
|
||||||
znt_list_instant_select - should pressing enter in search mode leave tool (0 or 1)
|
znt_list_instant_select - should pressing enter in search mode leave tool (0 or 1)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
If you used `ZNT` before `v2.1.12`, remove old configuration files `~/.config/znt/*.conf` so that `ZNT`
|
||||||
|
can update them to the latest versions that support integration with `Zshrc`. If you used installer
|
||||||
|
then run it again (after the remove of configuration files).
|
||||||
|
|
||||||
## Programming
|
## Programming
|
||||||
|
|
||||||
The function n-list is used as follows:
|
The function `n-list` is used as follows:
|
||||||
|
|
||||||
|
```zsh
|
||||||
n-list {element1} [element2] ... [elementN]
|
n-list {element1} [element2] ... [elementN]
|
||||||
|
```
|
||||||
|
|
||||||
This is all that is needed to be done to have the features like ANSI coloring,
|
This is all that is needed to be done to have the features like ANSI coloring,
|
||||||
incremental multi-word search, unique mode, horizontal scroll, non-selectable
|
incremental multi-word search, unique mode, horizontal scroll, non-selectable
|
||||||
elements (grepping is done outside n-list, see the tools for how it can be
|
elements (grepping is done outside `n-list`, see the tools for how it can be
|
||||||
done). To set up non-selectable entries add their indices into array
|
done). To set up non-selectable entries add their indices into array
|
||||||
NLIST_NONSELECTABLE_ELEMENTS:
|
`NLIST_NONSELECTABLE_ELEMENTS`:
|
||||||
|
|
||||||
|
```zsh
|
||||||
typeset -a NLIST_NONSELECTABLE_ELEMENTS
|
typeset -a NLIST_NONSELECTABLE_ELEMENTS
|
||||||
NLIST_NONSELECTABLE_ELEMENTS=( 1 )
|
NLIST_NONSELECTABLE_ELEMENTS=( 1 )
|
||||||
|
```
|
||||||
|
|
||||||
Result is stored as $reply[REPLY] ($ isn't needed before REPLY because
|
Result is stored as `$reply[REPLY]` (`$` isn't needed before `REPLY` because
|
||||||
of arithmetic context inside []). The returned array might be different from
|
of arithmetic context inside `[]`). The returned array might be different from
|
||||||
input arguments as n-list can process them via incremental search or uniq
|
input arguments as `n-list` can process them via incremental search or uniq
|
||||||
mode. $REPLY is the index in that possibly processed array. If $REPLY
|
mode. `$REPLY` is the index in that possibly processed array. If `$REPLY`
|
||||||
equals -1 it means that no selection have been made (user quitted via q
|
equals `-1` it means that no selection have been made (user quitted via `q`
|
||||||
key).
|
key).
|
||||||
|
|
||||||
To set up entries that can be jumped to with [,] keys add their indices to
|
To set up entries that can be jumped to with `[`,`]` keys add their indices to
|
||||||
NLIST_HOP_INDEXES array:
|
`NLIST_HOP_INDEXES` array:
|
||||||
|
|
||||||
|
```zsh
|
||||||
typeset -a NLIST_HOP_INDEXES
|
typeset -a NLIST_HOP_INDEXES
|
||||||
NLIST_HOP_INDEXES=( 1 10 )
|
NLIST_HOP_INDEXES=( 1 10 )
|
||||||
|
```
|
||||||
|
|
||||||
n-list can automatically colorize entries according to a Zsh pattern.
|
`n-list` can automatically colorize entries according to a `Zsh` pattern.
|
||||||
Following example will colorize all numbers with blue:
|
Following example will colorize all numbers with blue:
|
||||||
|
|
||||||
|
```zsh
|
||||||
local NLIST_COLORING_PATTERN="[0-9]##"
|
local NLIST_COLORING_PATTERN="[0-9]##"
|
||||||
local NLIST_COLORING_COLOR=$'\x1b[00;34m'
|
local NLIST_COLORING_COLOR=$'\x1b[00;34m'
|
||||||
local NLIST_COLORING_END_COLOR=$'\x1b[0m'
|
local NLIST_COLORING_END_COLOR=$'\x1b[0m'
|
||||||
local NLIST_COLORING_MATCH_MULTIPLE=1
|
local NLIST_COLORING_MATCH_MULTIPLE=1
|
||||||
n-list "This is a number 123" "This line too has a number: 456"
|
|
||||||
|
|
||||||
Blue is the default color, it doesn't have to be set. See zshexpn man page
|
n-list "This is a number 123" "This line too has a number: 456"
|
||||||
for more information on Zsh patterns. Briefly, comparing to regular
|
```
|
||||||
expressions, (#s) is ^, (#e) is $, # is *, ## is +. Alternative
|
|
||||||
will work when in parenthesis, i.e. (a|b). BTW by using this method you can
|
Blue is the default color, it doesn't have to be set. See `zshexpn` man page
|
||||||
|
for more information on `Zsh` patterns. Briefly, comparing to regular
|
||||||
|
expressions, `(#s)` is `^`, `(#e)` is `$`, `#` is `*`, `##` is `+`. Alternative
|
||||||
|
will work when in parenthesis, i.e. `(a|b)`. BTW by using this method you can
|
||||||
colorize output of the tools, via their config files (check out e.g. n-cd.conf,
|
colorize output of the tools, via their config files (check out e.g. n-cd.conf,
|
||||||
it uses this).
|
it is using this).
|
||||||
|
|
||||||
## Performance
|
## Performance
|
||||||
ZNT are fastest with Zsh before 5.0.6 and starting from 5.2
|
|
||||||
|
|
||||||
|
`ZNT` are fastest with `Zsh` before `5.0.6` and starting from `5.2`
|
||||||
|
|
||||||
|
## A tip
|
||||||
|
|
||||||
|
Zsh plugins may look scary, as they seem to have some "architecture". In fact, what a plugin really is, is that:
|
||||||
|
|
||||||
|
1. It has its directory added to `fpath`
|
||||||
|
2. It has any first `*.plugin.zsh` file sourced
|
||||||
|
|
||||||
|
That's it. When one contributes to Oh-My-Zsh or creates a plugin for any plugin manager, he only needs to account for this.
|
||||||
|
The same with doing any non-typical Zsh Navigation Tools installation.
|
||||||
|
|
||||||
|
## More
|
||||||
|
|
||||||
|
- be aware of [this](https://github.com/psprint/zsh-navigation-tools/blob/f49f910d239ae5bc6e1a5bb34930307b4f4e3ffe/zsh-navigation-tools.plugin.zsh#L35-L49)
|
||||||
|
|
||||||
|
## IRC Channel
|
||||||
|
|
||||||
|
Channel `#zplugin@freenode` is a support place for all author's projects. Connect to:
|
||||||
|
[chat.freenode.net:6697](ircs://chat.freenode.net:6697/%23zplugin) (SSL) or [chat.freenode.net:6667](irc://chat.freenode.net:6667/%23zplugin)
|
||||||
|
and join #zplugin.
|
||||||
|
|
||||||
|
Following is a quick access via Webchat [](https://kiwiirc.com/client/chat.freenode.net:+6697/#zplugin)
|
||||||
|
|
||||||
|
# Fixing tmux, screen and linux vt
|
||||||
|
|
||||||
|
If `TERM=screen-256color` (often a case for `tmux` and `screen` sessions) then
|
||||||
|
`ncv` terminfo capability will have `2`nd bit set. This in general means that
|
||||||
|
underline won't work. To fix this by creating your own `ncv=0`-equipped
|
||||||
|
terminfo file, run:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
{ infocmp -x screen-256color; printf '\t%s\n' 'ncv@,'; } > /tmp/t && tic -x /tmp/t
|
||||||
|
```
|
||||||
|
|
||||||
|
A file will be created in directory `~/.terminfo` and will be automatically
|
||||||
|
used, `tmux` and `screen` will work. Similar is for Linux virtual terminal:
|
||||||
|
|
||||||
|
```zsh
|
||||||
|
{ infocmp -x linux; printf '\t%s\n' 'ncv@,'; } > /tmp/t && tic -x /tmp/t
|
||||||
|
```
|
||||||
|
|
||||||
|
It will not display underline properly, but will instead highlight by a color,
|
||||||
|
which is quite nice. The same will not work for FreeBSD's vt, `ZNT` will detect
|
||||||
|
if that vt is used and will revert to highlighting elements via `reverse` mode.
|
||||||
|
|
||||||
vim:filetype=conf
|
|
||||||
|
|
|
||||||
|
|
@ -10,8 +10,8 @@ integer cygwin=0
|
||||||
local IFS="
|
local IFS="
|
||||||
"
|
"
|
||||||
|
|
||||||
case "$OSTYPE" in
|
case "$(uname)" in
|
||||||
cygwin*) list=( `command ps -Wa` ); cygwin=1 ;;
|
CYGWIN*) list=( `command ps -Wa` ); cygwin=1 ;;
|
||||||
*) list=( `command ps -o pid,uid,command -A` ) ;;
|
*) list=( `command ps -o pid,uid,command -A` ) ;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
|
@ -36,6 +36,6 @@ for line in "${list[@]}"; do
|
||||||
done
|
done
|
||||||
|
|
||||||
_wanted bits expl "Processes' name bits" \
|
_wanted bits expl "Processes' name bits" \
|
||||||
compadd "$@" -a - words && ret=0
|
compadd -M 'm:{a-z}={A-Z}' "$@" -a - words && ret=0
|
||||||
|
|
||||||
return "$ret"
|
return "$ret"
|
||||||
|
|
|
||||||
|
|
@ -42,8 +42,8 @@ NLIST_NONSELECTABLE_ELEMENTS=( 1 )
|
||||||
|
|
||||||
type ps 2>/dev/null 1>&2 || { echo >&2 "Error: \`ps' not found"; return 1 }
|
type ps 2>/dev/null 1>&2 || { echo >&2 "Error: \`ps' not found"; return 1 }
|
||||||
|
|
||||||
case "$OSTYPE" in
|
case "$(uname)" in
|
||||||
cygwin*) list=( `command ps -Wa` ) ;;
|
CYGWIN*) list=( `command ps -Wa` ) ;;
|
||||||
*) list=( `command ps -o pid,uid,command -A` ) ;;
|
*) list=( `command ps -o pid,uid,command -A` ) ;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -261,6 +261,8 @@ done
|
||||||
|
|
||||||
last_element="$#list"
|
last_element="$#list"
|
||||||
|
|
||||||
|
zcurses clear main redraw
|
||||||
|
zcurses clear inner redraw
|
||||||
while (( 1 )); do
|
while (( 1 )); do
|
||||||
# Do searching (filtering with string)
|
# Do searching (filtering with string)
|
||||||
if [ -n "$NLIST_SEARCH_BUFFER" ]; then
|
if [ -n "$NLIST_SEARCH_BUFFER" ]; then
|
||||||
|
|
|
||||||
|
|
@ -1,9 +1,30 @@
|
||||||
#!/usr/bin/env zsh
|
#!/usr/bin/env zsh
|
||||||
|
|
||||||
0="${(%):-%N}" # this gives immunity to functionargzero being unset
|
#
|
||||||
export ZNT_REPO_DIR="${0%/*}"
|
# No plugin manager is needed to use this file. All that is needed is adding:
|
||||||
|
# source {where-znt-is}/zsh-navigation-tools.plugin.zsh
|
||||||
|
#
|
||||||
|
# to ~/.zshrc.
|
||||||
|
#
|
||||||
|
|
||||||
|
# According to the standard:
|
||||||
|
# http://zdharma.org/Zsh-100-Commits-Club/Zsh-Plugin-Standard.html
|
||||||
|
0="${${ZERO:-${0:#$ZSH_ARGZERO}}:-${(%):-%N}}"
|
||||||
|
0="${${(M)0:#/*}:-$PWD/$0}"
|
||||||
|
export ZNT_REPO_DIR="${0:h}"
|
||||||
export ZNT_CONFIG_DIR="$HOME/.config/znt"
|
export ZNT_CONFIG_DIR="$HOME/.config/znt"
|
||||||
|
|
||||||
|
#
|
||||||
|
# Update FPATH if:
|
||||||
|
# 1. Not loading with a plugin manager
|
||||||
|
# 2. Not having fpath already updated
|
||||||
|
#
|
||||||
|
|
||||||
|
if [[ ${zsh_loaded_plugins[-1]} != */zsh-navigation-tools && -z ${fpath[(r)${0:h}]} ]]
|
||||||
|
then
|
||||||
|
fpath+=( "${0:h}" )
|
||||||
|
fi
|
||||||
|
|
||||||
#
|
#
|
||||||
# Copy configs
|
# Copy configs
|
||||||
#
|
#
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue