Mirrors/history-search-multi-word
2
0
Fork 0
mirror of https://github.com/zdharma-continuum/history-search-multi-word synced 2024-11-24 20:33:04 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
77 commits 1 branch 0 tags 316 KiB
Shell 100%
Find a file
Sebastian Gniazdowski 607dc2a73a Updated README.md (syntax highlighting customization)
2016-10-12 16:23:42 +02:00
history-search-multi-word Updated README.md (no manual installation, zstyles) and default Zstyles 2016-10-12 15:50:35 +02:00
history-search-multi-word.plugin.zsh Immediate commit after obtaining first working highlighting 2016-10-09 09:24:03 +02:00
hsmw-highlight *highlight: Fix style for path and path prefix – magenta is a color 2016-10-11 08:47:30 +02:00
LICENSE New license 2016-08-31 17:09:24 +02:00
README.md Updated README.md (syntax highlighting customization) 2016-10-12 16:23:42 +02:00

README.md

Introduction

Binds Ctrl-R to a widget that searches for multiple keywords in AND fashion. In other words, you can enter multiple words, and history entries that match all of them will be found.

Video – view on asciinema. You can resize the video by pressing Ctrl-+ or Cmd-+.

asciicast

News

  • 11-10-2016

    • Syntax highlighting of history – adapted, fine crafted part of zsh-syntax-highlighting to color what hsmw shows:

      syntax highlighting

  • 20-09-2016

    • Keys Page Up and Page Down work and page-wise move along history. Also, Ctrl-P, Ctrl-N move to previous and next entries

  • 19-09-2016

  • 25-05-2016

    • Cooperation with zsh-autosuggestions plugin

    • Configuration option to set page size, example use:

      zstyle ":history-search-multi-word" page-size "5"

Installation

The plugin is "standalone", which means that only sourcing it is needed. So to install, unpack history-search-multi-word somewhere and add

source {where-hsmw-is}/history-search-multi-word.plugin.zsh

to zshrc.

If using a plugin manager, then Zplugin is recommended, but you can use any other too, and also install with Oh My Zsh (by copying directory to ~/.oh-my-zsh/custom/plugins).

Zplugin

Add zplugin load psprint/history-search-multi-word to your .zshrc file. Zplugin will handle cloning the plugin for you automatically the next time you start zsh.

Antigen

Add antigen bundle psprint/history-search-multi-word to your .zshrc file. Antigen will handle cloning the plugin for you automatically the next time you start zsh. You can also add the plugin to a running zsh with antigen bundle psprint/history-search-multi-word for testing before adding it to your .zshrc.

Oh-My-Zsh

  1. cd ~/.oh-my-zsh/custom/plugins
  2. git clone git@github.com:psprint/history-search-multi-word.git
  3. Add history-search-multi-word to your plugin list

Zgen

Add zgen load psprint/history-search-multi-word to your .zshrc file in the same place you're doing your other zgen load calls in.

Customizing

Zstyles

zstyle ":history-search-multi-word" page-size "8"                      # Number of entries to show, default is LINES/3
zstyle ":history-search-multi-word" highlight-color "fg=yellow,bold"   # Color in which to highlight matched, searched text
zstyle ":plugin:history-search-multi-word" synhl "yes"                 # Whether to perform syntax highlighting

Syntax highlighting

Syntax highlighting is customized via HSMW_HIGHLIGHT_STYLES associative array. It has keys like reserved-word, alias, command, path, which are assigned with strings like fg=blue,bold, to configure how given elements are to be colored. If you assign this array you will change the defaults. Complete list of available keys is at the beginning of hsmw-highlight file.

IRC Channel

Channel #zplugin@freenode is a support place for all author's projects. Connect to: chat.freenode.net:6697 (SSL) or chat.freenode.net:6667 and join #zplugin.

Following is a quick access via Webchat IRC