This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+vim/vinegar/README.org

81 lines
3.1 KiB
Org Mode
Raw Normal View History

#+TITLE: Vinegar layer
2015-06-08 10:07:50 +00:00
2019-05-02 21:49:30 +00:00
#+TAGS: layer|vim
2019-05-07 20:05:06 +00:00
* Table of Contents :TOC_5_gh:noexport:
2017-05-22 14:16:12 +00:00
- [[#description][Description]]
2017-08-28 21:58:10 +00:00
- [[#features][Features:]]
2019-04-20 21:39:13 +00:00
- [[#install][Install]]
- [[#layer][Layer]]
- [[#reuse-dired-buffer][Reuse dired buffer]]
- [[#deactive-hide-details-mode][Deactive hide details mode]]
- [[#mouse-bindings][Mouse bindings]]
- [[#key-bindings][Key bindings]]
* Description
This layer is a port of vim-vinegar for Emacs.
2015-06-08 10:07:50 +00:00
It is based on tpope's [[https://github.com/tpope/vim-vinegar][vinegar.vim]], simplifying =dired=
2015-06-08 10:07:50 +00:00
with a limited number of details and exposing the ~-~ command in all
buffers to enter dired.
2017-08-28 21:58:10 +00:00
** Features:
2018-09-19 03:54:47 +00:00
- navigation up folders with ~-~ key
- simplify dired buffer to show only file names
- better evil/vim bindings for navigation within dired buffer
- keep only one active dired buffer
- Use dired-k extension to show time / vcs related information in
single bar
- right mouse click moves up directory if in blank space or shows context menu
2015-06-08 10:07:50 +00:00
2019-04-20 21:39:13 +00:00
* Install
** Layer
To use this configuration layer add =vinegar= to the
=dotspacemacs-configuration-layers= list.
** Reuse dired buffer
To reuse dired buffers set the variable =vinegar-reuse-dired-buffer= to =t=.
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(
(vinegar :variables
vinegar-reuse-dired-buffer nil))
2019-04-20 21:39:13 +00:00
#+END_SRC
** Deactive hide details mode
Per default extensive details in dired are hidden with this layer.
This can be deactivated by setting the variable =vinegar-dired-hide-details= to =nil=.
#+BEGIN_SRC emacs-lisp
(setq-default dotspacemacs-configuration-layers '(
(vinegar :variables
vinegar-dired-hide-details t)))
2019-04-20 21:39:13 +00:00
#+END_SRC
2015-06-08 10:07:50 +00:00
** Mouse bindings
| Mouse Binding | Description |
|---------------+-----------------------------------------------|
| ~mouse-1~ | (Dired) Open selected file |
| ~mouse-2~ | (Dired) Open clicked file in other-window |
| ~mouse-3~ | (Dired) Open context popup or go up directory |
** Key bindings
| Key binding | Description |
2015-06-08 10:07:50 +00:00
|-------------+----------------------------------------------------|
| ~-~ | Navigate to parent directory in dired |
| ~0~ | (Dired) Move to the beginning of the file in dired |
| ~=~ | (Dired) Diff between selected files |
| ~C-j~ | (Dired) Move to next subdirectory |
| ~C-k~ | (Dired) Move to previous subdirectory |
2015-06-08 10:07:50 +00:00
| ~I~ | (Dired) Toggle showing dotfiles |
| ~~~ | (Dired) Navigate to home directory |
| ~f~ | (Dired) Helm find file |
| ~J~ | (Dired) Goto file |
2015-06-08 10:07:50 +00:00
| ~C-f~ | (Dired) dired-find |
| ~H~ | (Dired) Show dired history |
| ~T~ | (Dired) Move down in dired tree |
| ~K~ | (Dired) Kill marked lines (hide, do not delete) |
| ~r~ | (Dired) Redisplay buffer |