Using GitHub Pages with Ghost and Buster on Windows (part 1)

Taking Inventory and Setting Up

First and foremost, if you are using Linux or OSX, follow this guide here and save yourself a lot of time.

Series:
Part 1: Taking Inventory and Setting Up
Part 2: Hacking Buster and Deploying

List of software

I'm assuming you have a GitHub account already, if not go create one now. I'll wait.

Installing node.js

node.js download

Installing node.js on Windows is really straight forward and very easy thanks to Joyent's installer. It truly is just a next, next, finish install. The one thing to watch out for is to make sure that you can access node and npm after the install. You may have to reboot for it to take full effect.

Let's make sure node is installed properly. Open a console and type in:

node --version

If it's installed properly, you should get a response like this:
v0.10.25 keep in mind your version may be different from when this article was written.

Now let's make sure NPM is installed correctly:

npm --version

Expect similar output as the first statement, but the versions won't match and they aren't meant to either. If you're having any trouble, try rebooting and repeating these steps first.

Installing Git Bash

Git Bash download

The installation of the Git Bash in Windows is done equally as well. It's another next, next, finish. There are some extra options that display during the install, but as long as you stick with all the defaults, i.e. don't change anything, you'll be fine.

Installing MinGW

MinGW download

Here's where we start to get a little more difficult. Follow the prompts and leave the default settings. Feel free to change the install directory, in fact it's very important that you keep track of it. For this reason, I installed it to C:\dev\MinGW. This will come into play as we install Python and when we modify our PATH. Once you have it installed, you'll want to set up the packages that we'll be using. Let's launch the MinGW Installation Manager.

Select the Basic Setup from the menu on the left. We just need to make sure we have two packages here, mingw32-base and msys-base. It should look like this.

Now let's get one other package we'll need. Click on the All Packages and scroll down to find msys-wget and set that package to install. Lastly click the Installation menu at the top and then Apply Changes. When you're done it should look like this.

As a final touch we're going to have to modify our PATH environment variable.

Modifying your PATH

Use the [Windows Key] + [Pause/Break Key] to launch your System Properties dialog. From here you'll want to click on the Advanced System settings. As soon as that dialog launches, click on the Environment Variables... button at the bottom.

Select the PATH variable and click Edit. All the values are semi-colon delimited. We'll need to add two new ones. Move to the end of the line of values and now make sure you add to following so the end looks like this:

;C:\dev\MINGW\msys\1.0\Bin;C:\dev\MINGW\Bin;

This will add all the msys tools and the mingw tools to your path so you can access them from any command prompt in Windows.

Installing Python

Python 2.7 download

Make sure you grab the 2.7.6 version or earlier. 3.0 or higher will not work right now. The author of buster is using the print statement throughout the package and in version 3 they changed it to a method call print().

Here I changed the installation directory to C:\dev\Python27 to keep all the libraries in the same root folder.

Once complete we'll need to modify the PATH again. Make sure you add the following to the end of the PATH values:

;C:\dev\Python27;C:\dev\Python27\scripts;

This will add Python and any scripts you install to the PATH so they can be called from any command prompt in Windows.

Let's test it!

Launch your Git Bash, or preferred command prompt. Type in the following command and if you get a version number back, you're good!

python --version

Installing PIP

PIP download

Don't get scared when you click on that link, it's supposed to look like that. Just right click anywhere on that page and select Save As.... Make sure to name the file get-pip.py. I would suggest saving it to the C:\dev folder to make it easy.

Once that's done, let's launch Git Bash and type in the following commands:

$ cd /c/dev
$ python get-pip.py

You'll see it install PIP. Now to test it out. If you get a version number, you're good!

pip --version

Setup Complete!

You're now ready to move on to the next part which will be getting Ghost and buster running.

Alexander Kahoun

I'm a Software Engineer currently at Neudesic (http://neudesic.com). I'm also a Geek, Abstractionist, Recursionist, Technologist, Gamer, Husband, Dad, and Jedi Knight. I do what I love.

  • Gilbert, AZ, USA
comments powered by Disqus