From 6e8d816ada2445fb098f76418deceef6c9eb049d Mon Sep 17 00:00:00 2001 From: Přemysl Eric Janouch Date: Thu, 1 Oct 2020 04:07:56 +0200 Subject: README.adoc: split into subsections --- README.adoc | 34 ++++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/README.adoc b/README.adoc index 9f7be70..a1637be 100644 --- a/README.adoc +++ b/README.adoc @@ -45,8 +45,11 @@ Or you can try telling CMake to make a package for you. For Debian it is: There is also a Makefile you can use to quickly build a binary to be copied into the PATH of any machine you want to have 'sdn' on. +Integration +----------- + zsh ---- +~~~ To start using this navigator, put the following in your '.zshrc': .... @@ -65,25 +68,25 @@ bindkey '\eo' sdn-navigate .... fish ----- +~~~~ To start using this navigator, put the following in your 'config.fish': .... function sdn-navigate - set --local IFS - while eval (sdn | string replace -ar '^(.*?)=' 'set --$1 ') - test -z "$cd" || cd "$cd" - test -z "$insert" || commandline --insert "$insert " - test -z "$helper" && break - eval $helper || break - end - commandline --function repaint + set --local IFS + while eval (sdn | string replace -ar '^(.*?)=' 'set --$1 ') + test -z "$cd" || cd "$cd" + test -z "$insert" || commandline --insert "$insert " + test -z "$helper" && break + eval $helper || break + end + commandline --function repaint end bind \eo sdn-navigate .... bash ----- +~~~~ Here we can't reset the prompt from within a `bind -x` handler but there is an acceptable workaround that sadly submits a blank line: @@ -112,8 +115,11 @@ bind -x '"\201": sdn-restore' bind '"\eo":"\200\C-m\201"' .... +Configuration +------------- + Colours -------- +~~~~~~~ Here is an example of a '~/.config/sdn/look' file; the format is similar to that of git, only named colours aren't supported: @@ -128,7 +134,7 @@ Filename colours are taken from the `LS_COLORS` environment variable. Run `dircolors` to get some defaults. Bindings --------- +~~~~~~~~ To obtain more vifm-like controls, you may write the following to your '~/.config/sdn/bindings' file: @@ -139,7 +145,7 @@ normal ? help .... Helper programs ---------------- +~~~~~~~~~~~~~~~ The F3 and F4 keys are normally bound to actions 'view' and 'edit', similarly to Norton Commander and other orthodox file managers. The helper programs used here may be changed by setting the PAGER and VISUAL (or EDITOR) environment -- cgit v1.2.3-70-g09d2