]> Sergey Matveev's repositories - nnn.git/commitdiff
Plugin readme improvement
authorDoug Headley <dheadl@ext.uber.com>
Thu, 29 Oct 2020 23:35:41 +0000 (16:35 -0700)
committerDoug Headley <dheadl@ext.uber.com>
Sat, 31 Oct 2020 05:00:46 +0000 (22:00 -0700)
plugins/README.md

index 3d2a609cdfb099b2c0468800351fd80749248aad..772f28e14cc3257fa6659bca00d8467a05646418 100644 (file)
@@ -94,6 +94,23 @@ To pick and run an unassigned plugin, press <kbd>Enter</kbd> (to _enter_ the plu
 
 To run a plugin at startup, use the option `-P` followed by the plugin key.
 
+If the plugins list gets too long, try breaking them up into sections:
+
+```
+NNN_PLUG_PERSONAL='g:personal/convert2zoom;p:personal/echo'
+NNN_PLUG_WORK='j:work/prettyjson;d:work/foobar'
+NNN_PLUG_INLINE='e:_go run $nnn*'
+NNN_PLUG_DEFAULT='1:bookmarks;2:ipinfo;p:preview-tui;o:fzz;b:nbak'
+NNN_PLUG="$NNN_PLUG_PERSONAL;$NNN_PLUG_WORK;$NNN_PLUG_DEFAULT;$NNN_PLUG_INLINE"
+export NNN_PLUG
+```
+
+Note:
+- `'g:personal/convert2zoom'` will look in the personal sub-folder inside the plugin folder.
+- `'b:boom;b:bookmarks` will result in only the first definition of *b* (`b:boom`) being used.
+- A keybinding definition of more than 1 character will prevent nnn from starting.
+
+
 #### Skip directory refresh after running a plugin
 
 `nnn` refreshes the directory after running a plugin to reflect any changes by the plugin. To disable this (say while running the `mediainf` plugin on some filtered files), add a `-` before the plugin name: