muon: Static blog generator

[ bsd3, program, web ] [ Propose Tags ]

Program which takes blog posts and pages written in Markdown and compiles them into a tree of HTML pages which can then be served by any web server.

Muon is similar in function to Hakyll but has far fewer features (and dependencies) and is generally not ready for use in production as of yet.

[Skip to Readme]
Versions [faq],,,,,,,,
Dependencies base (==4.6.*), blaze-html (==0.7.*), directory (==1.2.*), Glob (==0.7.*), HStringTemplate (==0.7.*), markdown (==0.1.*), process (==1.2.*), text (==0.11.*) [details]
License BSD-3-Clause
Copyright Copyright (c) 2014 Kaashif Hymabaccus
Author Kaashif Hymabaccus
Category Web
Home page;a=summary
Source repo head: darcs get
Uploaded by kaashif at Sun Apr 13 22:31:01 UTC 2014
Distributions NixOS:
Executables muon
Downloads 4149 total (230 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
Successful builds reported [all 6 reports]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for muon-

[back to package description]
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

First, install the package by getting the darcs repo.

    $ darcs get

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/

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

    $ muon generate

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 ""
will always come before "", regardless of the date contained in the file.

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