-*- outline -*-
Chalkboard 

In short, copy data-examples/ to data/ and visit index.html.

* How to configure WebDAV and Subversion repository.

The Chalkboard has options to save user data.

- Local (no web server): Read only
- Local + Firefox: You can save a file through mozilla API in a local file.
- With apache + WebDAV: Read and Write
- With Apache + WebDAV + Subversion: Read and Write with version control.

If you use the Chalkboard without Apache, or with WebDAV, simply
access index.html

** Using WebDAV

Apache2 supports WebDAV by default. This is the simplest example of
setting for apache's configuration file. You might need to security
configuration above that.

<Directory "/Users/takashi/tinlizzie/chalkboard/data">
    Header add MS-Author-Via "DAV"
    DAV On
    Options Indexes
</Directory>

** Using WebDAV and Subversion (for Mac OSX)

*** Install WebDAV and Subversion

Mac OSX supports subversion by default, but there was a version
conflict issue in my machine. So I will show you how to set up with
Macports. PHP is required to show a version history with WebSVN.

$ sudo port install subversion +mode_dav_svn
$ sudo port install php5

In these commands, another apache2 is installed where:

Config file: /opt/local/apache2/conf/httpd.conf
Error log: /opt/local/apache2/logs/error_log 
Start command: sudo /opt/local/apache2/bin/apachectl start

This is an example snippet of the config file.

# PHP5 setting
LoadModule php5_module        modules/libphp5.so
AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps

# PHP5 Subversion setting
LoadModule dav_svn_module     modules/mod_dav_svn.so
LoadModule authz_svn_module   modules/mod_authz_svn.so

<Location "/tinlizzie/chalkboard/data/">
    Header add MS-Author-Via "DAV"
    DAV svn
    SVNPath "/Users/takashi/tinlizzie/chalkboard/data.svn/"
    SVNAutoversioning on
    Options Indexes
</Location>

To make an empty subversion repository (for Ubuntu use www-data instead of _www):

$ svnadmin create data.svn
$ sudo chown -R _www data.svn
$ sudo chmod -R g+w data.svn

And copy data-example to the repository

$ svn co file:///$PWD/data.svn data.local

$ cp data/* data.local/
$ cd data.local/
$ svn add *
$ svn commit -m 'initial check in'

*** Install WebSVN http://websvn.tigris.org/

To install WebSVN, extract WebSVN as websvn/

$ chmod 777 websvn/cache
$ cp websvn/include/distconfig.php websvn/include/config.php

Add a line to specify URL of the repository into config.php like:

$config->addRepository('data', 'file:///Users/takashi/tinlizzie/chalkboard/data.svn/');