mirror of
https://github.com/jarun/nnn.git
synced 2024-11-24 11:51:27 +00:00
Update docs
This commit is contained in:
parent
5cd9794102
commit
f80563e16a
|
@ -59,7 +59,7 @@ Add to that an awesome [Wiki](https://github.com/jarun/nnn/wiki)!
|
||||||
- Run plugins and commands with custom keybinds
|
- Run plugins and commands with custom keybinds
|
||||||
- FreeDesktop compliant trash (needs trash-cli)
|
- FreeDesktop compliant trash (needs trash-cli)
|
||||||
- Cross-dir file/all/range selection
|
- Cross-dir file/all/range selection
|
||||||
- Batch rename selection or dir entries
|
- Batch renamer (feature-limited) for selection or dir
|
||||||
- Copy (as), move (as), delete, archive, link selection
|
- Copy (as), move (as), delete, archive, link selection
|
||||||
- Create (with parents), rename, duplicate (anywhere) files and dirs
|
- Create (with parents), rename, duplicate (anywhere) files and dirs
|
||||||
- Spawn a shell, run apps, run commands, execute file
|
- Spawn a shell, run apps, run commands, execute file
|
||||||
|
|
|
@ -102,13 +102,9 @@ Plugins can also access the current selections by reading the `.selections` file
|
||||||
|
|
||||||
## Create your own plugins
|
## Create your own plugins
|
||||||
|
|
||||||
Plugins are a powerful yet easy way to extend the capabilities of `nnn`.
|
|
||||||
|
|
||||||
Plugins are scripts that can be written in any scripting language. However, POSIX-compliant shell scripts runnable in `sh` are preferred.
|
Plugins are scripts that can be written in any scripting language. However, POSIX-compliant shell scripts runnable in `sh` are preferred.
|
||||||
|
|
||||||
Each script has a _Description_ section which provides more details on what the script does, if applicable.
|
Once it's ready, drop the plugin in `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins` and make it executable. Optionally add a custom keybind in `$NNN_PLUG` if you intend to use the plugin frequently.
|
||||||
|
|
||||||
The plugins reside in `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`.
|
|
||||||
|
|
||||||
#### Controlling `nnn`'s active directory
|
#### Controlling `nnn`'s active directory
|
||||||
`nnn` provides a mechanism for plugins to control its active directory.
|
`nnn` provides a mechanism for plugins to control its active directory.
|
||||||
|
@ -156,6 +152,6 @@ There are many plugins provided by `nnn` which can be used as examples. Here are
|
||||||
|
|
||||||
## Contributing plugins
|
## Contributing plugins
|
||||||
|
|
||||||
Please keep non-portable commands (like `notify-send`) commented so users from any other OS/DE aren't surprised.
|
Add informative sections like _Description_, _Notes_, _Dependencies_, _Shell_, _Author_ etc. in the plugin as applicable. Add an entry in the table above. Please keep non-portable commands (like `notify-send`) commented so users from any other OS/DE aren't surprised.
|
||||||
|
|
||||||
The plugins should be executable. Please add an entry in the table above.
|
The plugins should be executable.
|
||||||
|
|
Loading…
Reference in a new issue