Public Repository

Last pushed: 7 months ago
Short Description
Brute force static site generator for Ghost
Full Description

Buster





Docker Hub

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.

About this fork

This is a work in progress containing many of the pull requests made to the
original buster repo (which unfortunately has been abandoned by its author).

It includes most of the changes by

  • skosch
  • petemichel77
  • Misiur
  • Jeongseok Son
  • raccoony
  • leftofnull
  • alokard

It should also work with static pages (e.g. about, tag/..., etc.).

There may well be issues still, especially around Windows compatibility; I'm
happy to merge your PRs.

Installation

With pip installed, simply run

pip install git+https://github.com/boggin/buster

You could also just clone the source and use the buster.py file directly.

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

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.

Requirements

  • 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 <https://github.com/docopt/docopt>: Creates beautiful
    command line interfaces easily.
  • GitPython <https://github.com/gitpython-developers/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.

Buster?

Inspired by THE GhostBusters.

Contributing

Checkout the existing issues or create a new one. Pull requests welcome (actually, this time)!

Docker Pull Command
Owner
unsettling

Comments (0)