Readme for muon-0.1.0.3
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.