sponsor Vim development Vim logo Vim Book Ad

Fist of Vim : Super simple and awesome gist support for vim

 script karma  Rating 9/3, Downloaded by 2057  Comments, bugs, improvements  Vim wiki

created by
Akshay Hegde
 
script type
utility
 
description
Fast, simple and super awesome Gist-ing for Vim.

## Dependencies
- https://github.com/defunkt/gist.git - "Potentially the best command line gister"

Install and configure it by running:

    [sudo] gem install gist && gist --login

## Usage
Only breathing is easier than using Fist of Vim.

Fist of Vim defines these super simple mappings by default:

1. <leader>p - Create a new Gist

2. <leader>u - Update an existing Gist

3. <leader>l - List your public Gists

You can use create or update a Gist with a visual selection, or in normal mode,
in which case, it is motion based.

For example, in normal mode, <leader>pG will create a new Gist from the
cursor to the end of file. In visual mode, you can simply select and then hit
<leader>p to create a new Gist.

Fist of Vim also sets the filetype and syntax completely automatically without
you having to set it!

As the philosopher, Staples Inc., once said, "That was easy!"

### Custom Maps
Fist of Vim allows you to choose the Fist to hold the gavel with. In other
words, you can assign your own maps for these:

1. <plug>fov_new           - Create a new Gist (normal mode)

2. <plug>fov_update       - Update a Gist (normal mode)

3. <plug>fov_visual_new    - Create a new Gist (visual mode)

4. <plug>fov_visual_update - Update a Gist (visual mode)

5. <plug>fov_list          - List your Gists.

Example: nmap <leader>f <plug>fov_new.

### Configuration
Fist of Vim offers these hilariously named variables so it can be configured to your exacting standards:

1. g:fist_opens_browser - Open the new/updated Gist in the browser.

2. g:fist_in_private    - Create a secret Gist

3. g:fist_no_maps       - Don't define any mappings automatically.

4. g:fist_dispatch      - When listing Gists, do it asynchronously (requires dispatch.vim from https://github.com/tpope/vim-dispatch)
 
install details

## Install
If you use Vim 8 or better, simply copy and paste:

    git clone https://git.sr.ht/~ackyshake/fist.vim ~/.vim/pack/vendor/start/vim-fist

Once the helptags have been generated (:helptags ALL), see :help vim-fist for usage.
 

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
vim-fist-1.8.tar.gz 1.8 2021-01-06 7.3 Akshay Hegde - Now creates a secret gist by default
- Fixed incorrect function name reference
- Fixed an issue where creating a gist with visual mode would use the contents of the unnamed register instead of the selection.
vim-fist-1.7.zip 1.7 2015-01-11 7.3 Akshay Hegde * Finally fixes any gist updating issues.

This version also means that if you can simply enter `let @f = "<gist url here>"` and then use the Fist of Vim's update command and have the gist updated.
vim-fist-1.6.zip 1.6 2014-12-24 7.3 Akshay Hegde * Better UX when listing gists
* Added a g:fist_dispatch variable to optionally use async when listing gists
* Fixed an issue where filename was not getting set.
* Cleaned up default maps to not use `hasmapto()` to prevent errors.
* Documentation updates
vim-fist-1.5.zip 1.5 2014-12-21 7.3 Akshay Hegde Major changes:

Fixed an issue creating a Gist with linewise motions.
Fixed several issues with updating a Gist with both normal and visual modes.
Modified all functions to be private
Updated documentation
vim-fist-1.4.zip 1.4 2014-12-19 7.3 Akshay Hegde * Add ability to list the user's gists.
* Allow users to disable Fist of Vim default mappings.
* Fix an issue where gists aren't created to the end of a line.
vim-fist.zip 1.3 2014-07-18 7.3 Akshay Hegde Major Changes:

* Added ability to define new mappings for creating/updating gists.
* Bug Fixes
vim-fist-1.2.zip 1.2 2014-06-24 7.3 Akshay Hegde Major changes:

- Fixed gisting from visual mode.
- Gisting from normal mode is now motion based (See :h vim-fist)
- You can now update your existing gists from

Minor Changes:
This plugin is now called Fist of Vim
vim-fist-1.0.zip 1.0 2014-06-24 7.3 Akshay Hegde Initial upload
ip used for rating: 18.97.14.81

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
   
Vim at Github