1. Introduction

This is the codebase used for the blog application at http://www.libcoffee.net/. Libcoffee.net is written based on the Django framework, and is intended to be run on a Google App Engine account.

2. Features

Basic features:

• Basic blog authoring and publishing with plain URLs eg 'blog/2009/12/31/slug'
• Comments with Google, OpenID and Facebook identities
• Content markup with reStructuredText, Markdown and Textile
• XMPP and email notifications for new comments
• Clean default template with Blueprint CSS, hAtom microformats
• Code block syntax highlighting
• Trackbacks and pingbacks
• Spam checking with Akismet
• Scheduled datastore backup via email
• Movable Type/MetaWeblog API

3. Installation

Libcoffee.net depends on a bunch of Python libraries and some custom Django apps that were ported to App Engine's BigTable. Check out the Dependencies section for details. Fill out settings.py for app configuration, or use local_settings.py if you prefer.

After that, it's the same as starting up Django's development server:

echo 'Just running the dev server'
./manage.py runserver
echo 'and uploading to AppEngine...'
common/.google_appengine/appcfg.py update .

4. Dependencies

• app-engine-patch
• Django 1.1 (bundled with app-engine-patch)
• Google App Engine SDK (latest, follow aep's setup instructions)
• pygments
• python-docutils (optional)
• python-markdown 2.0 (optional)
• python-openid
• django-xmlrpc

Some tiny libraries are already checked in to Git:

• BeautifulSoup
• Facebook Python API, from django-socialauth
• python-feedparser
• python-textile

Also included are a few Django apps ported to App Engine, and heavily modified:

• django.contrib.comments
• django-openid-auth (AppEngine port)
• django-trackback

All libraries are expected to be in the lib/ folder, or in a ZIP archive and placed in common/zip-packages.

4. License

Libcoffee.net is licensed under the Creative Commons Attribution-Share Alike license.

All third-party parts shamelessly included here are distributed under their respective licenses.