Using Buster – A Static Site Generator for Ghost
![](https://i0.wp.com/chrisyee.ca/wp-content/uploads/2014/07/ghostbusters-logo.png?fit=1311%2C800&ssl=1)
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.
Requirements
- Ghost installed locally on your computer
- Python
- Terminal
Install pip
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:
pip --version
Install Homebrew
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:
brew --version
Install Buster
Once pip and Homebrew are both installed, you can install Buster on your computer.
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:
buster --version
Using Buster
1. At first you’ll need to setup Buster, run this command in the terminal:
buster setup
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:
https://github.com/yourgithubusername/repo.git
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.
buster preview
6. Finally you can deploy the static files to the GitHub repo:
buster deploy
From here on, you can host the generated static files on GitHub Pages or upload the generated static files to your shared hosting.
Comments
Comments are closed.
I Have tried to create static files with all types of tools and in all im getting one error, that whenevr i open my ghost static file, the cover image of the post is not available, when i view the location of the image, the lcation is write however the extesnion is wrong, for ex file:///home/kush-ubuntu/Documents/try/docs/content/images/size/w600/2019/06/chennai-img.jpegg , see the extra g? in some sizes its jpegjpg…idk how to solve this, im getting this in even buster.
I have to solve this issue manually each time i do buster generate, what is causing this issue?
Sorry I don’t use Ghost or Buster anymore. It looks like Buster isn’t maintained anymore but it looks like some people have created some alternatives.