Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Tree: 1dc134df87
Fetching contributors…

Cannot retrieve contributors at this time

71 lines (49 sloc) 2.174 kB

Lightning is a static blogging engine designed to make it painless to author and update large blogs. Key features are:

  • Standalone content directory.
  • Incremental building.
  • Easy-to-author configuration.
  • Use your favorite editor for everything.

Here's a preview of publishing using lightning once you're set up.

Installation

  1. Clone the repository via git clone git@github.com:borismus/lightning.git
  2. Run cd lightning to get to your newly cloned repository.
  3. Install all required dependencies by running pip install -r requirements.txt.
  4. Run ./lightning to build and ./lightning preview to run a webserver.
  5. Open http://localhost:8000 in your browser.

Usage

Build incrementally.

> ./lightning

Forcibly rebuild everything regardless of whether or not there have been changes made to the content. This is useful if you change your template.

> ./lightning rebuild

Start watching for local changes to the content, rebuilding incrementally based on that.

> ./lightning watch

Start a really simple local web server with its document root pointing to the output directory.

> ./lightning preview

Configuration

  1. lightning.yaml specifies where to look for content, template and where to dump output.
  2. site.yaml in your content directory specifies site-specific configuration.

For production

I use a combination of Dropbox and Lightning (which uses inotify-tools) to make for a pleasant blogging experience. Here are the steps to get Lightning working on your server.

  1. Install Dropbox on your server.
  2. Install Lightning on your server (see above).
  3. Customize your theme.
  4. Configure lightning.yaml to look for your content on Dropbox (eg. ~/Dropbox/my-blog/)
  5. Setup a watcher on your server via lightning watch. It's useful to run the watcher using nohup.
  6. Make some changes to your content directory from any Dropbox client (I sometimes use Nebulous on iPad).
  7. You're done.

Enjoy.

Jump to Line
Something went wrong with that request. Please try again.