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.
- Clone the repository via
git clone email@example.com:borismus/lightning.git
cd lightningto get to your newly cloned repository.
- Install all required dependencies by running
pip install -r requirements.txt.
./lightningto build and
./lightning previewto run a webserver.
- Open http://localhost:8000 in your browser.
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
Deploy the site to the specified S3 bucket.
> ./lightning deploy
lightning.yaml specifies where to look for content, template and where
to dump output. It also specifies where to deploy the site.
site.yaml specifies metadata about the site itself, including
permalinks, verbs, site title, date format. It belongs in the content
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.
- Install Dropbox on your server.
- Install Lightning on your server (see above).
- Customize your theme.
lightning.yamlto look for your content on Dropbox (eg.
- Setup a watcher on your server via
lightning watch. It's useful to run the watcher using
- Make some changes to your content directory from any Dropbox client (I sometimes use Nebulous on iPad).
- You're done.