Getting started with bamboo
First, if you have a index.html file in your home directory, remove it before you do anything else.
Then edit your b.site file. This is the general configuration for the website.
Here is a good example file to get your started:
; the name of the website
sitename = My very wonderful site
; what template to use for the site appearance
decorator = spartan
; set up a single static user and password:
userbackend = static, admin:mysecretpass
; allow only txt and html files.
allowed-types = txt html
; set permissions
access-view = anonymous
access-edit = admin
More options can be found at
dev.riseup.net/bamboo.
Creating a decorator
To customize how your site looks, you need to create a custom decorator (also known as a theme, skin, template, etc).
In this example, our decorator will be named "superfine".
- Go to the bamboo site, click edit, type in some text, then hit "Publish". This is required to kick start your bamboo site.
- Create the directory ~/.bamboo/superfine.
- Copy the simple example decorator:
cp -vr /var/www/bamboo-latest/decorators/basic/* ~/.bamboo/superfine
- edit the template.php and style.php files to suit your needs.
- Make the group be www-data, and make all files group readable and executable. For example:
cd .bamboo
chgrp www-data superfine -R
chmod g+rX superfine -R
- Edit your b.site file so that bamboo will use your new decorator:
decorator = superfine