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]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 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 && <4.7), blaze-html (>=0.7 && <0.8), ConfigFile (>=1.1 && <1.2), directory (>=1.2 && <1.3), Glob (>=0.7 && <0.8), HStringTemplate (>=0.7 && <0.8), markdown (>=0.1 && <0.2), MissingH (>=1.2 && <1.3), process (>=1.2 && <1.3), text (>=0.11 && <0.12) [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 2014-04-14T21:50:06Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables muon
Downloads 6058 total (24 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Successful builds reported [all 6 reports]

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.