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 by has far fewer features (and dependencies) and is generally not ready for use in production as of yet.

[Skip to Readme]
Versions [RSS] [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 2014-04-13T22:26:58Z
Distributions NixOS:
Executables muon
Downloads 5354 total (34 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.