Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Static site generator for Ghost and Github

Project description

Super simple, Totally awesome, Brute force static site generator for Ghost.

Start with a clean, no commits Github repository.

Generate Static Pages. Preview. Deploy to Github Pages.

Warning! This project is a hack. It’s not official. But it works for me.

The interface

setup [--gh-repo=<repo-url>]

      Creates a GIT repository inside static/ directory.

generate [--domain=<local-address>]

      Generates static pages from locally running Ghost instance.


      Preview what’s generated on localhost:9000.


      Commits and deploys changes static files to Github repository.

add-domain <domain-name>

      Adds CNAME file with custom domain name as required by Github Pages.

Buster assumes you have static/ folder in your current directory (or creates one during setup command). You can specify custom directory path using [--dir=<path>] option to any of the above commands.

Don’t forget to change your blog URL in config.js in Ghost.

The Installation

Installing Buster is easy with pip:

$ pip install buster

You’ll then have the wonderful buster command available.

You could also clone the source and use the file directly.


  • wget: Use brew install wget to install wget on your Mac. Available by default on most linux distributions.
  • git: Use brew install git to install git on your Mac. sudo apt-get install git on ubuntu/debian

The following python packages would be installed automatically when installed via pip:

  • docopt: Creates beautiful command line interfaces easily.
  • GitPython: Python interface for GIT.

Ghost. What?

Ghost is a beautifully designed, completely customisable and completely Open Source Blogging Platform. If you haven’t tried it out yet, check it out. You’ll love it.

The Ghost Foundation is not-for-profit organization funding open source software and trying to completely change the world of online publishing. Consider donating to Ghost.


Inspired by THE GhostBusters.

Ghost Buster Movie Poster

Ghost Buster Movie


Checkout the existing issues or create a new one. Pull requests welcome!

Made with jugaad in Dilli.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for buster, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size buster-0.1.3.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page