= Divan =

Divan is a simple blogging platform that is [source:trunk/examples/divan included] with Diva as an example application.

It uses [http://incubator.apache.org/couchdb/ CouchDB] (via the [http://code.google.com/p/couchdb-python/ CouchDB-Python] library) for storage.

It supports comments with [http://openid.net/ OpenID authentication], [http://hixie.ch/specs/pingback/pingback-1.0 pingbacks], [http://atomenabled.org/ Atom feeds] for the whole blog, individual categories, and comments, and the [http://atomenabled.org/developers/protocol/ Atom publishing protocol]. It does not provide a HTML-based interface for authoring entries, nor does it support the XML-RPC based !MetaWeblog API.

== Setting Up ==

You'll need Diva, [http://incubator.apache.org/couchdb/ CouchDB] (0.8 or later), and [http://code.google.com/p/couchdb-python/ CouchDB-Python] (trunk) installed. CouchDB needs to be running, and it needs to contain an empty database named "divan" (the name can be changed using a config option, see below).

Change into the `examples/divan` directory in the Diva source, and run:

{{{
$ PYTHONPATH=. ./divan/app.py -v
[INFO] diva.server: Serving <__main__.Blog object at 0x5c0290> on 127.0.0.1:8080
}}}

This will install (or update) the view definitions in the database, and run the web application on `http://localhost:8080/`.

See the DevelopmentServer page for more server options.

== Configuration Options ==

In addition to the core Diva [ConfigOptions options], Divan can be customized using the following options:

 `blog_author`:: Name of the author of the blog
 `blog_author_email`:: Email address of the blog author
 `blog_title`:: Name of the blog
 `db_uri`:: URI of the CouchDB database (for example `http://127.0.0.1:5984/myblog/`)
 `media_dir`:: Path to a local directory where media resources (managable via !AtomPub) are stored. If not set, media collection management is not provided.
 `moderation_email_to`:: The email address that moderation notification mails should be sent to