The bamboo package

[Tags: gpl, library]

A simple blog engine on Hack

[Skip to ReadMe]


Versions2009.4.22, 2009.4.23, 2009.4.25, 2009.4.26, 2009.4.27, 2009.4.30, 2009.4.50, 2009.4.52, 2009.5.13, 2009.5.18, 2009.5.18.1, 2009.5.18.2, 2009.5.19, 2009.5.22, 2009.5.23, 2009.5.27, 2009.6.6, 2009.6.8, 2009.6.9, 2009.6.25, 2009.8.16, 2009.11.1, 2010.1.1, 2010.1.26, 2010.2.25
Dependenciesansi-wl-pprint, base, base64-string, bytestring, cgi, containers, data-default (>=0.2), directory, filepath, gravatar (>=0.3), hack (>=2009.4.30), hack-contrib (>=2009.4.50), haskell98, hcheat (>=2008.11.6), kibro (>=0.4.2), MissingH, mps (>=2008.11.6), network, old-locale, old-time, pandoc, parsec (>=2), parsedate (>=3000.0.0), process, rss (>=3000.0.1), template, time, unix, utf8-string (>=0.3.3), xhtml, zlib [details]
AuthorWang, Jinjing
MaintainerWang, Jinjing <>
Home page
UploadedMon Apr 27 23:23:48 UTC 2009 by JinjingWang
Downloads4146 total (86 in last 30 days)
0 []
StatusDocs uploaded by user
Build status unknown [no reports yet]




Maintainers' corner

For package maintainers and hackage trustees

Readme for bamboo-2009.4.50

Bamboo: a simple blog engine on Hack

Bamboo is a port of Panda, but runs on top of Hack. It's an experimental project but quite portable.


plain text as data source

|---- blog
|     |---- 08-09-01 first post
|     |---- 09-09-02 learn javascript.html
|---- tag
|     |---- programming
|     |---- funny
|---- static
      |---- About

simple config

blog_title    = C大调
blog_subtitle = 野猫不吃薯片
host_name     =
author_email  =

navigation    = About
per_page      = 7
sidebar       =
favicon       = bamboo_icon.png

hacker friendly



My blog source is available as a git repo:

git clone git://

Or browser online

Note: This blog is using the Kibro handler. It's running under lighttpd and in fcgi. Definitely more robust, but require some set up work.


jinjing's blog config file


Install Bamboo Middleware

update cabal

cabal update

install bamboo

cabal install happy
cabal install rss --reinstall
cabal install hack
cabal install hack-contrib
cabal install bamboo

Choose a hack handler


install hyena
cabal install network --reinstall

git clone git://
cd hyena
cabal install

cabal install hack-handler-hyena
get a starter kit ( template )
mkdir myblog
cd myblog

# get a template to start
git clone git:// db
create an entry point

put this into Main.hs

module Main where

import Bamboo
import Hack.Handler.Hyena

import Hack.Utils
import Hack.Contrib.Middleware.ContentType
import Hack.Contrib.Middleware.ContentSize
import Hack.Contrib.Middleware.ShowExceptions
import Hack.Contrib.Middleware.Static

import qualified Hack.Contrib.Head as H

default_content_type = "text/plain; charset=UTF-8"

middleware_stack = 
  [  dummy_middleware

  -- completeness
  ,  content_size
  ,  content_type default_content_type

  -- debuging
  ,  show_exceptions Nothing

  -- optimization
  ,  H.head

  -- static serve
  ,  static (Just "db/public") ["/theme", "/images", "/plugin", "/favicon.ico"]

  -- real app
  ,  bamboo

app = use middleware_stack dummy_app

main = run app
ghc --make -O2 Main.hs

It should be running on now.


Install Kibro
cabal install kibro
cabal install hack-handler-kibro
Install lighttpd 1.4.19 (used by kibro)
tar zxfv lighttpd-1.4.19.tar.gz
cd lighttpd-1.4.19
./configure --prefix=$HOME
make install

make sure ~/sbin is in your $PATH.

You also need spawn-fcgi in your path. I don't remember how I got mine, but it should come with lighttpd somewhere ...

# bamboo is a kibro project
kibro new myblog
cd myblog

# get a template to start
git clone git:// db
sh db/extra/scripts/
kibro start

It should be running on now.