Rakepage is a tiny Rakefile that builds a static website from Markdown pages and static assets.
Be warned that this is one of those Works For Me (TM) projects -- it's my first contact with Ruby/Rake and I wrote it both to learn about the language(s) and because I thought it might make my life a bit easier. I use it to build a small, static website, and find it very useful.
Rakepage requires Ruby, Rake, and the Kramdown and Liquid gems. The
depends on Watchr.
This could be the directory structure of a small Rakepage project:
|- Rakefile |- site.yaml |- layouts |- _default.liquid |- _footer.liquid |- _header.liquid |- ... |- media |- css |- ... |- js |- ... |- output |- pages |- about.md |- contact.md |- index.md |- ...
Create the directory structure, then copy
site.yaml into the
project's root. Then create your pages, edit the configuration file, and when
rake gen) to convert all the Markdown pages into HTML, embed them in the
Liquid layout and copy them and the static assets to
While you are tweaking your site,
is your friend: It simply triggers
rake whenever a file changes on the
disk -- normally the site is regenerated before you can press Alt-Tab and F5.
site.yaml for all the configuration options.