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.

As of now, Muon supports:

[Skip to Readme]
Versions [faq],,,,,,,,
Dependencies base (==4.6.*), blaze-html (==0.7.*), ConfigFile (==1.1.*), directory (==1.2.*), Glob (==0.7.*), happstack-server (==7.3.*), HStringTemplate (==0.7.*), markdown (==0.1.*), MissingH (==1.2.*), 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-17T21:33:05Z
Distributions NixOS:
Executables muon
Downloads 5320 total (9 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 server.

Installing from Darcs
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

Installing from Hackage
Installing from Hackage using Cabal is as simple as:

    $ cabal install muon

Bear in mind this may not be the most up-to-date version, but it will be
a stable version.

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

Previewng the site locally:

    $ muon serve

Uploading site to server:

    $ muon upload

Multiple commands in sequence:

    $ muon init generate upload
    $ muon generate serve

Configuring Muon
After "muon init" is run, a file called "config.ini" is created. This is
where you configure the blog. By default, it should look like this:

    title=Default site
    author=Your Name
    tagline=Something descriptive


The [site] section needs little explanation - you can preview the site
yourself and see where those strings go. The "style" option denotes the
location of a custom CSS file.

The [remote] section is to configure the command run by Muon to upload
the site. The command is "rsync -a --delete site/ user@server:dir", with
the key words replaced with your SSH credentials on a server. If you're
not sure if the configuration is correct, remember: the directory must
end in a slash!

Extra Pages
Aside from a homepage, archive, and posts, you might want some extra
pages on your site, like "" or "".
You can add such pages to your site simply by creating a file with the
right name in the "pages/" directory of your blog.

For example, if your blog is at "" and you want a page at
"", edit the file "pages/mypage" and fill it with HTML.
Bear in mind, this content will go in between the "header" and "footer"
templates, so you don't need to include <body> or <html> tags. Here's
how you might do that:

    $ cat >> pages/mypage <<EOF
    <h2>My Custom Page</h2>
    <p>This is a page I made!</p>

And that's that! Next time you "muon generate upload", the pages will be
accessible at "".

Writing Posts
To add a new post, create a new file in the "posts/" directory with the
suffix ".post".

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.

In the archive, posts are ordered lexicographically, _not_ by date.
This means "" will always come above "", regardless of
the date contained in the file itself. This allows you to decide the
order of your posts yourself, if you want to separate tutorials and
rants, for example.