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.
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
Preview what's generated on localhost:9000
.
deploy
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.
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 buster.py
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
:
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.
Docker is an easy way to run Buster in an isolated environment.
Substitute a Github access token
for ${TOKEN}, your https stype repository URL for
$ TOKEN=q2e42be10665b0307069a56bc389f342a797d34e
$ REPO=github.com/you/your_repo.git
$ SITE=my_ghost_blog.com
$ sudo docker run axitkhurana/buster /bin/sh -c "buster setup-clone --gh-repo=https://${TOKEN}@${REPO} && buster generate --domain=${SITE} && buster deploy"
If you only ever use Buster, then you only have to run setup-clone once. After that you could store and reuse the container for generate & deploy.
Checkout the existing issues or create a new one. Pull requests welcome!