muon

Muon is a static blog generator, meaning that it takes files written in convenient markup and converts it to HTML and CSS ready to deploy to a web server.

Installing

First, install the package by getting the darcs repo.

$ darcs get http://repos.kaashif.co.uk/muon

You can install it using cabal, which you should have installed.

$ cd muon
$ cabal install

After that, assuming you have configured cabal and/or your PATH correctly, muon should be usable. Here are some things you may want to do:

Using Muon

Initialising a blog:

$ mkdir new-blog
$ cd new-blog
$ muon init

Writing a post:

$ vi posts/new.post

Regenerating the site, creating a tree of files in the ./site directory.

$ muon generate

Notes

When writing posts, make sure you put the title on the first line, the date on the second, and a short description (for the archive) on the third line. The rest should be valid Markdown. See the posts/ directory after site initialisation for some examples.

The posts are ordered lexicographically, not by date. This means "aaa.post" will always come before "bbb.post", regardless of the date contained in the file.

"muon upload" is currently hardcoded. Stay tuned for per-blog config files.