I do now have .vim/bundle/plugin/fetch.vim
which I tried adding to my .vimrc
, but it fails.
If you want to manually install the plug-in by unpacking the files into locations your Vim will find, then you should store the plugin/fetch.vim
into ~/.vim/plugin/fetch.vim
(no bundle/
element there.) And the plug-in also depends on the autoload/
component, so you should also unpack autoload/fetch.vim
into your ~/.vim/autoload/fetch.vim
.
(There's also an autoload/stay/integration/fetch.vim
, but it seems you only need it if you're also using the vim-stay plug-in.)
If you're unpacking the files manually, you might want to also unpack the documentation from doc/vim-fetch.txt
into your ~/.vim/doc/vim-fetch.txt
and then index it with :helptags ~/.vim/doc
inside Vim (so that :help vim-fetch-usage
and smilar commands will work from inside Vim.)
Having said that, there's not much benefit to unpacking plug-ins manually these days, since both you have rich plug-in managers that do the heavy lifting for you and, even if you don't like them, you can use native Vim packages.
For Vim packages, create a new directory ~/.vim/pack/<some-name>/start
where you can pick <some-name>
as appropriate to you, just avoid reserved names such as plugin
(plural plugins
is fine), using bundle
is a popular choice, or pick your own username perhaps.
Then unpack vim-fetch
there, so you'll have ~/.vim/pack/<some-name>/start/vim-fetch
with all the subdirectories such as plugin/
, autoload/
and doc/
directly under it. You will need to create the help index explicitly with :helptags ~/.vim/pack/<some-name>/start/vim-fetch/doc
.
My actual recommendation is to use a plug-in manager, I tend to find it makes it much easier to install and maintain plug-ins that way (even if I fully understand and like the low-level approach of native Vim packages myself.) I recommend vim-plug, which is very easy to use but also very featureful and modern.
Plug-in managers such as vim-plug (and its predecessor Vundle) will often use directories such as ~/.vim/bundle
to store the plug-ins they download. But in that case, they will add one more level of directories with the plug-in name under bundle
. So instead of ~/.vim/bundle/plugin/fetch.vim
(as you mentioned in the question), that file will be present in ~/.vim/bundle/vim-fetch/plugin/fetch.vim
.
But it's not enough to just place the file there... The magic of the plug-in managers is to update 'runtimepath'
to incude ~/.vim/bundle/vim-fetch
(and the other plug-ins they manage), so that Vim will be able to find the files plugin/fetch.vim
and autoload/fetch.vim
that make this plug-in work.
If you're using a plug-in manager such as vim-plug, you don't need to worry about creating help tags, since vim-plug will do that automatically for you.
Finally, for completeness, if you really want to use the Vimball file vim-fetch-3.0.0.vmb
available from vim-fetch's Releases page on GitHub, then download that vim-fetch-3.0.0.vmb
file and open it with Vim, as in:
~/Downloads$ vim vim-fetch-3.0.0.vmb
Vim will show you a screen that has the following in it:
" Vimball Archiver by Charles E. Campbell, Jr., Ph.D.
UseVimball
finish
...
***vimball*** Source this file to extract it! (:so %)
The last line is actually telling you how to install it. You just source it, so execute the suggested :source
command:
:so %
This will install the Vimball you currently have opened.
But note that the most recent Vimball for vim-fetch, for version 3.0.0, was created on March 5, 2018, over 2 years ago. The GitHub page also tells you there were 12 commits to the repository since this version was cut. So for those reasons alone, you should avoid using Vimballs.
Not to mention that a Vimball is not only harder to initially install, but also harder to track, upgrade, uninstall. Vimballs have lost popularity to Vim plug-in managers for a good reason, so I'd recommend avoiding Vimballs as much as you can.