https://github.com/pabsan-0/vim-actions

Vim shortcut action list powered by fzf
https://github.com/pabsan-0/vim-actions

productivity repos-ecosystem vim vim-plug vim-plugin vimrc

Last synced: 11 days ago
JSON representation

Vim shortcut action list powered by fzf

• Host: GitHub
• URL: https://github.com/pabsan-0/vim-actions
• Owner: pabsan-0
• Created: 2024-08-21T12:35:57.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2024-10-24T16:21:08.000Z (27 days ago)
• Last Synced: 2024-10-25T22:51:57.732Z (26 days ago)
• Topics: productivity, repos-ecosystem, vim, vim-plug, vim-plugin, vimrc
• Language: Vim Script
• Homepage:
• Size: 6.84 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# actions.vim

Shortcut action list powered by `fzf` fuzzy-finding. 

Offshore cognitive effort into a persistent, project-specific list of repeating actions. Common use cases include:

- Go to faraway files: config files, system headers, repos you're basing your project off...

- Execute arbitrary vim commands (including shell commands)

- Update and source an action list tailored to your current project



## Installation

This plugin requires you to have [fzf.vim](https://github.com/junegunn/fzf.vim) first.

Using vim-plug:

```

Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }

Plug 'junegunn/fzf.vim'

Plug 'pabsan-0/vim-actions'

```

## Usage 

If unused, the plugin will set `q` as default mapping to call the action list.

The point of this plugin is speed, nonetheless you can also call it via the slower `:Actions`. 

## System-wide actions

Your personal default list of actions can be defined in your `~/.vimrc` by setting the variable `g:actions_list`. Find an example below. 

About action lists: 

- Notice the usage of the `|` to separate action names and targets.

- Lines will be displaying in reverse, i.e top-to-bottom, in the fzf menu.

- Empty lines are to make chunks out of the actions, and will reflect on the fzf menu.

 ```

 let g:actions_list = [ 

     \ ["Source local rc       | :source .vimrc "], 

     \ ["Edit local rc         | :edit .vimrc   "], 

     \ ["                                       "], 

     \ [".gitconfig            | ~/.gitconfig   "], 

     \ [".vimrc                | ~/.vimrc       "], 

     \ ["                                       "], 

     \ ] 

 ```

## Project-wise actions

For project-specific actions, use a local `.vimrc` file at the root of your project that updates `g:actions_list`.

Here's a few examples on how this file may look like.

https://github.com/pabsan-0/vim-actions/blob/be959d1c19b96d1a045689af41ff32f6039e9df5/samples/.vimrc-extend#L4-L10

https://github.com/pabsan-0/vim-actions/blob/be959d1c19b96d1a045689af41ff32f6039e9df5/samples/.vimrc-replace#L4-L7

For maximum convenience, your default action list should include an action to source this file. An extra custom mapping to handle this file is not recommended, since it only gives you more stuff to think about.