Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Installing on Windows
Note: This guide is not for cygwin, and assumes you have installed Ruby via the one-click installer. These steps are known to work with 32/64 bit versions of Windows 7, 8, 8.1 and 10 (tech-preview).
Before you start
Check if you are running a 32-bit or 64-bit Windows install. The Ruby one-click-installer and Ruby Devkit come in both flavours. With the wrong version, you will have issues installing lolcommits gem dependencies that require native compiling.
- With 'Start' screen open, just type "system' and select 'System' in the 'Search result panel'
- Listed under 'System type' it will display 32 or 64 bit
First, please ensure you have git installed and working. The
git command should be available in your Windows command prompt. Type
git --version to check the install worked.
- Download ImageMagick from here e.g.
ImageMagick-6.8.0-3-Q16-windows-dll.exe. NOTE: At the time of writing this older version of ImageMagick is known to work with the MiniMagick gem on Windows. Ymmv with newer or different versions of ImageMagick and the MiniMagick gem.
- When prompted make sure Add application directory to your system path is checked before proceeding.
- Close and reopen your command prompt to reload your PATH variables.
convert -vto check the install worked.
There are many ways to install Ruby on Windows. To get up and running quickly we recommend the one-click installer. Make sure you choose a Ruby version that has a compatible Ruby Development Kit available (see below).
Download and run the installer following the prompts to complete the installation. When prompted make sure Add Ruby executables to your PATH is checked before proceeding. Close, then re-open your command prompt and type
ruby -v to check the install worked.
Ruby Development Kit
After installing Ruby, you'll need the Ruby Development Kit. This provides extra libraries and modules necessary for installing some Ruby gems with C bindings. We'll need this for some of lolcommits dependencies.
- Grab the Ruby Development Kit from here
- Unpack it somewhere (e.g.
- Open a command prompt and
cdto this directory
ruby dk.rb initto prepare the install
ruby dk.rb reviewto review the install
ruby dk.rb installto complete the install
For more information or troubleshooting see https://github.com/oneclick/rubyinstaller/wiki/Development-Kit.
Woo, that's it! All the prerequisites have been taken care of. Now all you need to do is install lolcommits and enable it in your own git repo.
gem install lolcommits cd C:\your_repo lolcommits --enable
Note: For any of steps above, re-opening your command prompt may not refresh your PATH environment variable on some versions of Windows, and a full restart may be required.
If you run into any issues, copy your error and Google around.