Buster is a static site generator for Ghost made by Akshit Khurana. It is used to generate static HTML + CSS from your local Ghost install, this is perfect for using Ghost on shared hosting (no need for Node.js!).
In this short tutorial I’ll be going through the steps on how to install and use Buster. I used a mac to install Buster, but the steps should be fairly similar on Linux or Windows since the install process + usage is done though the command line.
- Ghost installed locally on your computer
Buster is written in Python. In order to install Buster, you will need pip which is a Python package manager. Follow their official install guide to get pip installed on your computer.
Check if your computer has pip installed by running this command in the terminal:
Buster requires wget, this can be installed through Homebrew which is a package manager for Mac. Follow their official install guide to get Homebrew on your computer.
Check if your computer has Homebrew installed by running this command in the terminal:
Just run the following commands in the terminal:
pip install buster
brew install wget
To make sure you have successfully installed buster, you can run this command in the terminal:
1. At first you’ll need to setup Buster, run this command in the terminal:
2. Buster will then ask for you to “Enter the Github repository URL:”. You’ll need to have an empty GitHub repo at hand. Enter the url and be sure to change the username to your GitHub username and repo to your repo name:
3. Now you can generate the static files:
buster generate --domain=http://127.0.0.1:2368
If you are using a different domain or port for local Ghost install, you should alter the command above.
5. With the preview command you can preview the generated output on your Mac’s default browser.
6. Finally you can deploy the static files to the GitHub repo:
From here on, you can host the generated static files on GitHub Pages or upload the generated static files to your shared hosting.