Vim-Makefile
A lightweight non-dependency Makefile for install, uninstall, bundle, distribute Vim plugin scripts.
DESCRIPTION
I wrote this because I saw people using Rakefile to install plugin scripts. but some people don't have rake on their system, and the Rakefile is not flexible for users to extend rules and which can't bundle dependented scripts too.
GNU's make is ths most commonly used utility, which is almost in every system,
so it basically doesn't have other dependencies.
This Makefile provides features to install,uninstall,bundle,distribute vim plugin. it's simple
, quick and lightweight. And you can also use vim-makefile to generate vimball distribution.
(More details of vimball, please see :help vimball section)
And I also appended a util vim-makefile to fetch the latest Makefile. you can
simply run vim-makefile to generate the Makefile.
The default behavior is, When installing vim scripts, your plugin name will be
current directory name, and will search files from all directories to
install. Files with .vim extension of current directory will be installed too.
(but please make sure you've added a comment like "script type: plugin in your script)
Then Makefile will use vim script to generate an installation record in JSON
format (also Vim dictionary format), which is located at
$(VIMRUNTIME)/record/{plugin_name}
INSTALLATION
Put bin/vim-makefile to your PATH, e.g.
$ cp bin/vim-makefile /usr/bin/
USAGE
To initialize a Makefile for plugin:
$ cd your_plugin
$ vim-makefile # will download fresh Makefile from github
And your scripts should be put in {type}/ directories. for example:
autoload/blah.vim
plugin/aaa.vim
ftplugin/bbb.vim
snippets/xxxx.snippets
Or you can also just put a vim file in current directory:
commenter.vim
But Please add a comment below to your script file:
" script type: {type}
where {type} is your script type. just replace it with 'plugin' ,'ftplugin' or something else.
To install scripts:
$ make install
To uninstall scripts:
$ make uninstall
To link scripts:
$ make link
To import dependented scripts:
$ make bundle
To clean up stuff:
$ make clean
To create dist tarball:
$ make dist
To create vimball distribution:
$ make vimball
If you want to edit the filelist of vimball:
$ make vimball-edit
To update Makefile:
$ make update
To install plugins to other runtime path:
$ make install VIMRUNTIME=~/.testing-vim
CUSTOMIZE
config.mk
To customize makefile config , you can simply create a config.mk file , which
is optional , for example:
$ make config
This will generate config.mk, now you can edit the file:
NAME=hypergit.vim
VIMRUNTIME=~/.vim
VERSION=0.2
To define dependencies
add GIT_SOURCES macro to your config.mk
GIT_SOURCES= \
[email protected]:c9s/html5.vim.git \
[email protected]:c9s/perlomni.vim.git
# dependency checkout path (optional)
DEPEND_DIR=/tmp/vim-depes
~/vimauthor.mk
TODO
FUNCTIONS
fetch_github
$(call fetch_github,[account id],[project],[branch],[source path],[target path])
fetch_url
$(call fetch_url,[file url],[target path])
fetch_local
$(call fetch_local,[from],[to])
Examples:
$(call fetch_github,c9s,treemenu.vim,master,plugin/treemenu.vim,plugin/treemenu.vim)
$(call fetch_url,http://......,plugin/xxxx.vim)
BUNDLE DEPENDENTED SCRIPTS
You can bundle dependented scripts when making a distribution ,add these
lines below to your config.mk file:
bundle-deps:
$(call fetch_github,c9s,treemenu.vim,master,plugin/treemenu.vim,plugin/treemenu.vim)
$(call fetch_github,c9s,helper.vim,master,plugin/helper.vim,plugin/helper.vim)
Then you can just bundle scripts from elsewhere:
$ make bundle
So if you want to make a distribution , you can just type:
$ make dist
Then the {plugin_name}.tar.gz will come out.
FREEBSD
For users are using FreeBSD as platform. please execute gmake (GNU Makefile) instead of make.
And ensure your gmake is using bash shell.
Setup SHELL env in Makefile or config.mk to let Makefile work.
SHELL = /opt/local/bin/bash
Then run:
$ gmake install