This repo is an educational tool to be used at jeremyckahn's Vimconf.live workshop session. It should work on OS X, Windows, and Linux.
Click to expand
Hello! I'm Jeremy Kahn, a Senior UI Engineer at Rally Health. I've been using Vim for about 9 years and love it for its customizability and efficiency. When I'm not making videos about how I tweak Vim to tame gnarly codebases, I like to develop open source web games and animation tools.
- Install Docker
- Clone this Git repo. (
git clone https://github.com/jeremyckahn/vim-docker-env.git
) cd
into this repo.- Run this command at the root of this repo:
On Linux and OS X:
docker run -it --rm -v "$(pwd)":/home/vimuser jeremyckahn/vimconf.live:latest
On Windows (must be done in Powershell):
docker run -it --rm -v ${PWD}:/home/vimuser jeremyckahn/vimconf.live:latest
From here you'll be in a Linux-based container environment. The home directory configuration files in this environment are the same as the ones in the Git repo root. Modifying a home directory file in the container will modify the same file in the host environment (and vice-versa).
Once in the Linux environment, you can boot Vim with vim
. From here enter :PlugInstall
to install the plugins that we'll go over in the workshop. Once that process is complete, you can either enter :Reload
or simply quit Vim and boot it up again for the changes to take effect.
Note: To get back into this Vim environment again later, you'll just need to run the docker run
command from step 1 as you did the first time. You won't need to do step 2 again, as the files installed by that step were placed in the Git repo on your host machine, which persist across Docker container instances.
While an entire Docker container isn't necessary to run Vim as it's configured here, it provides a consistent environment for all session participants as well as an easy setup. You could even use it as a starting point for your own Vim-based IDE, if you wanted to!