mirror of
https://github.com/jarun/nnn.git
synced 2024-09-11 04:55:25 +03:00
Updated Power toys (markdown)
parent
20e9479644
commit
856ba03563
@ -1,4 +1,54 @@
|
||||
### 1. Redirect selection to a command
|
||||
### 1. Pin a frequently visited directory
|
||||
|
||||
If you need to repeat a directory repeatedly, you can pin it during a session using the shortcut <kbd>,</kbd>. When you have a pinned directory, pressing the bookmark key (<kbd>b</kbd> or <kbd>\^/</kbd>) will list `,` as the first key:
|
||||
|
||||
bookmark keys: , w t m i d v n
|
||||
|
||||
Press <kbd>,</kbd> after the bookmark key to visit the pinned directory.
|
||||
|
||||
You can pin one directory at a time.
|
||||
|
||||
### 2. Filter filtered entries
|
||||
|
||||
Filtering is the `nnn` way to search files in a directory. Did you know it's possible to apply a new filter on already filtered results?
|
||||
|
||||
- Go to a directory
|
||||
- Press filter key (<kbd>/</kbd>) and type a filter
|
||||
- Press <kbd>Esc</kbd> or <kbd>Up</kbd> or <kbd>Down</kbd> (the filter will disappear from the status bar)
|
||||
- Press filter key again
|
||||
- Type a new filter to find matches in the earlier filtered results
|
||||
|
||||
### 3. Mount and modify archives
|
||||
|
||||
`nnn` provides you an option to mount archives when you press <kbd>Enter</kbd> on an archive. Press <kbd>m</kbd> to mount the archive and `nnn` will mount the archive and take you to the mountpoint of the mounted archive.
|
||||
|
||||
Add some files in the mounted archive, go back to the `nnn` config directory (`${XDG_CONFIG_HOME:-$HOME/.config}/nnn`) and hover on the archive mount point. Press <kbd>u</kbd> to unmount the archive and generate a package with the new files. The original package is saved with the extension `.orig`.
|
||||
|
||||
### 4. Hovered file path in `$nnn`
|
||||
|
||||
`nnn` exports the hovered file path as `$nnn` when you press the command prompt or spawn shell shortcuts. You can use the variable to run a command on the hovered file:
|
||||
|
||||
```sh
|
||||
ls -l "$nnn"
|
||||
```
|
||||
|
||||
### 5. Preview and edit files
|
||||
|
||||
You can easily edit and view the changes to Markdown, man pages etc. in `nnn`. For this you need to use a CLI file opener. You can use plugin [`nuke`](https://github.com/jarun/nnn/blob/master/plugins/nuke), a customizable example opener to specify your preferred apps. To set nuke as the default opener:
|
||||
|
||||
```sh
|
||||
export NNN_OPENER=/absolute/path/to/nuke
|
||||
```
|
||||
|
||||
and start `nnn` as `nnn -c`.
|
||||
|
||||
The option `-c` indicates to `nnn` that the opener is a CLI-only opener (note that `nuke` can open files in GUI apps as well; please read the documentation in the file).
|
||||
|
||||
Now when you press <kbd>Enter</kbd> on a Markdown file `nuke` will try to open it in `glow` or a man page in `man`.
|
||||
|
||||
To edit the file in `$VISUAL` (or `$EDITOR`, or `vi`), hover on the file and press <kbd>e</kbd>.
|
||||
|
||||
### 6. Redirect selection to a command
|
||||
|
||||
`nnn` allows users to select a file at a time, a range of files or all files in a directory together. Once you are done selecting, you can run a command on all the files by using the selection file as input:
|
||||
|
||||
@ -20,56 +70,6 @@ xargs -0 ls -l < $sel
|
||||
|
||||
Many plugins work this way!
|
||||
|
||||
### 2. Pin a frequently visited directory
|
||||
|
||||
If you need to repeat a directory repeatedly, you can pin it during a session using the shortcut <kbd>,</kbd>. When you have a pinned directory, pressing the bookmark key (<kbd>b</kbd> or <kbd>\^/</kbd>) will list `,` as the first key:
|
||||
|
||||
bookmark keys: , w t m i d v n
|
||||
|
||||
Press <kbd>,</kbd> after the bookmark key to visit the pinned directory.
|
||||
|
||||
You can pin one directory at a time.
|
||||
|
||||
### 3. Filter filtered entries
|
||||
|
||||
Filtering is the `nnn` way to search files in a directory. Did you know it's possible to apply a new filter on already filtered results?
|
||||
|
||||
- Go to a directory
|
||||
- Press filter key (<kbd>/</kbd>) and type a filter
|
||||
- Press <kbd>Esc</kbd> or <kbd>Up</kbd> or <kbd>Down</kbd> (the filter will disappear from the status bar)
|
||||
- Press filter key again
|
||||
- Type a new filter to find matches in the earlier filtered results
|
||||
|
||||
### 4. Mount and modify archives
|
||||
|
||||
`nnn` provides you an option to mount archives when you press <kbd>Enter</kbd> on an archive. Press <kbd>m</kbd> to mount the archive and `nnn` will mount the archive and take you to the mountpoint of the mounted archive.
|
||||
|
||||
Add some files in the mounted archive, go back to the `nnn` config directory (`${XDG_CONFIG_HOME:-$HOME/.config}/nnn`) and hover on the archive mount point. Press <kbd>u</kbd> to unmount the archive and generate a package with the new files. The original package is saved with the extension `.orig`.
|
||||
|
||||
### 5. Hovered file path in `$nnn`
|
||||
|
||||
`nnn` exports the hovered file path as `$nnn` when you press the command prompt or spawn shell shortcuts. You can use the variable to run a command on the hovered file:
|
||||
|
||||
```sh
|
||||
ls -l "$nnn"
|
||||
```
|
||||
|
||||
### 6. Preview and edit files
|
||||
|
||||
You can easily edit and view the changes to Markdown, man pages etc. in `nnn`. For this you need to use a CLI file opener. You can use plugin [`nuke`](https://github.com/jarun/nnn/blob/master/plugins/nuke), a customizable example opener to specify your preferred apps. To set nuke as the default opener:
|
||||
|
||||
```sh
|
||||
export NNN_OPENER=/absolute/path/to/nuke
|
||||
```
|
||||
|
||||
and start `nnn` as `nnn -c`.
|
||||
|
||||
The option `-c` indicates to `nnn` that the opener is a CLI-only opener (note that `nuke` can open files in GUI apps as well; please read the documentation in the file).
|
||||
|
||||
Now when you press <kbd>Enter</kbd> on a Markdown file `nuke` will try to open it in `glow` or a man page in `man`.
|
||||
|
||||
To edit the file in `$VISUAL` (or `$EDITOR`, or `vi`), hover on the file and press <kbd>e</kbd>.
|
||||
|
||||
### 7. Prompt shortcuts
|
||||
|
||||
Even if you compile `nnn` without libreadline, the native input prompts support several readline-like keys - <kbd>\^A</kbd>, <kbd>\^B</kbd>, <kbd>\^D</kbd>, <kbd>\^E</kbd>, <kbd>\^F</kbd>, <kbd>\^K</kbd>, <kbd>\^U</kbd>, <kbd>\^W</kbd>.
|
Loading…
Reference in New Issue
Block a user