Last modified 5 years ago Last modified on 11/10/08 13:41:42

Divan

Divan is a simple blogging platform that is included with Diva as an example application.

It uses CouchDB (via the CouchDB-Python library) for storage.

It supports comments with OpenID authentication, pingbacks, Atom feeds for the whole blog, individual categories, and comments, and the 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, CouchDB (0.8 or later), and 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 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