Skip to content

Latest commit

 

History

History
112 lines (83 loc) · 2.97 KB

README.rst

File metadata and controls

112 lines (83 loc) · 2.97 KB
Raw

zaw - zsh anything.el-like widget

install

$ git clone git://github.com/nakamuray/zaw.git
remote: Counting objects: 136, done.
remote: Compressing objects: 100% (86/86), done.
remote: Total 136 (delta 43), reused 136 (delta 43)
Receiving objects: 100% (136/136), 23.68 KiB, done.
Resolving deltas: 100% (43/43), done.
$ echo "source ${PWD}/zaw/zaw.zsh" >> ~/.zshrc

and restart zsh or manualy source zaw.zsh.

usage

press ^X;,

  1. select source and press enter.

  2. filter items with zsh patterns separated by spaces, use ^N, ^P and select one.

  3. execute action by pressing enter key or press Meta + enter for alternative action.

    instead, press tab key and select action you want to execute.

sources

currently these sources are available:

  • bookmark
  • git-files
  • git-showbranch
  • history
  • memo
  • named-cmd
  • open-file
  • perldoc
  • screens

shortcut widgets

zaw automaticaly create shortcut widgets for each sources that directly access to the source.

for example, execute bindkey '^R' zaw-history and press ^R to access history source.

you can get all available shortcut widgets' name using zaw-print-src:

$ zaw-print-src
source name      shortcut widget name
----------------------------------------
bookmark         zaw-bookmark
git-files        zaw-git-files
history          zaw-history
perldoc          zaw-perldoc

key binds and styles

zaw use filter-select to filter and select items.

you can use these key binds:

enter:              accept-line (execute default action)
meta + enter:       accept-search (execute alternative action)
Tab:                select-action
^G:                 send-break
^H, backspace:      backward-delete-char
^F, right key:      forward-char
^B, left key:       backward-char
^A:                 beginning-of-line
^E:                 end-of-line
^W:                 backward-kill-word
^K:                 kill-line
^U:                 kill-whole-line
^N, down key:       down-line-or-history (select next item)
^P, up key:         up-line-or-history (select previous item)
^V, page up key:    forward-word (page down)
^[V, page down key: backward-word (page up)
^[<, home key:      beginning-of-history (select first item)
^[>, end key:       end-of-history (select last item)

and these zstyles to customize styles:

':filter-select:highlight' selected
':filter-select:highlight' matched
':filter-select:highlight' title
':filter-select' max-lines
':filter-select' case-insensitive

example:
  zstyle ':filter-select:highlight' matched fg=yellow,standout
  zstyle ':filter-select' max-lines 10 # use 10 lines for filter-select
  zstyle ':filter-select' max-lines -10 # use $LINES - 10 for filter-select
  zstyle ':filter-select' case-insensitive yes # enable case-insensitive search

license

BSD-3