packages feed

muon-0.1.0.0: README

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.