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 http://jaspervdj.be/hakyll/ but has far fewer features (and dependencies) and is generally not ready for use in production as of yet.


[Skip to Readme]
Versions 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.0.4, 0.1.0.5, 0.1.0.6, 0.1.0.7, 0.1.0.8
Dependencies base (==4.6.*), blaze-html (==0.7.*), ConfigFile (==1.1.*), directory (==1.2.*), Glob (==0.7.*), 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
Maintainer kaashifhymabaccus@gmail.com
Category Web
Home page http://repos.kaashif.co.uk/darcs?r=muon;a=summary
Source repo head: darcs get http://repos.kaashif.co.uk/muon
Uploaded by kaashif at Mon Apr 14 21:50:06 UTC 2014
Distributions NixOS:0.1.0.8
Executables muon
Downloads 2769 total (8 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Successful builds reported [all 6 reports]
Hackage Matrix CI

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for muon-0.1.0.3

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