From ba85e9e6c758432ca77e13e3c53643a8887c1a17 Mon Sep 17 00:00:00 2001 From: David Thompson Date: Sun, 12 Apr 2015 10:24:19 -0400 Subject: Update README. * README.md: Update intro. Add example configuration and usage. --- README.md | 44 +++++++++++++++++++++++++++++++++++++++----- 1 file changed, 39 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 5be85cc..c07e81c 100644 --- a/README.md +++ b/README.md @@ -4,17 +4,51 @@ Haunt About ----- -Haunt is a static site generator written in Guile Scheme. +Haunt is a static site generator written in Guile Scheme. It's +simple, functional, and extensible. Features -------- -* SXML templates +* Easy blog and Atom feed generation +* Supports any markup language that can be parsed to SXML * Simple development server -* Easy deployment -* Extensible +* Purely functional build process +* User extensible + +Example Configuration +--------------------- + +``` +(use-modules (haunt site) + (haunt reader) + (haunt builder blog) + (haunt builder atom) + (srfi srfi-19)) + +(site #:title "Built with Guile" + #:domain "dthompson.us" + #:default-metadata + '((author . "David Thompson") + (email . "davet@gnu.org") + ;; If I'm careless and forget a date, use the UNIX epoch. + (date . (make-date 0 0 0 0 1 1 1970))) + #:readers (list sxml-reader html-reader) + #:builders (list (blog) + (atom-feed) + (atom-feeds-by-tag))) +``` + +Usage +----- + +Write a configuration file named `haunt.scm`. Add your posts to a +directory named `posts`. Then run `haunt build`! + +To view your creation, run `haunt serve` and browse to +`localhost:8080`. License ------- -GNU GPLv3 +GNU GPLv3 or later -- cgit v1.2.3