Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 2.96 KB

README.rst

File metadata and controls

93 lines (66 loc) · 2.96 KB
Raw

Libcoffee.net Blog Engine

Author: Jerry Chong
Contact: zanglang@gmail.com
Website:http://www.libcoffee.net/
Version: 0.2 (perpetually alpha ;)
Copyright: Creative Commons Attribution-Share Alike

1. Introduction

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

2. Features

Basic features:

  • Basic blog publishing with plain URLs eg 'blog/2009/12/31/slug'
  • Content markup with reStructuredText, Markdown and Textile
  • Clean default template with Bootstrap CSS, hAtom microformats
  • Code block syntax highlighting

Several features have been dropped or 'unimplemented' in favor of using third-party services, or due to deprecation:

  • Post creation and editing (via Google App Engine administration)
  • Comments, email notifications and spam checking (via Disqus)
  • Email notifications of new comments (via Disqus)
  • Scheduled datastore backup via Blobstore (via Google App Engine cron jobs)

Work-in-progress:

  • Movable Type/MetaWeblog API

3. Installation

Libcoffee.net depends on the AppEngine Python SDK, the excellent flask-appengine-template, as well as a few Python libraries.

If you've cloned this repository from Github, flask-appengine-template should already have been linked as a git submodule. To populate the folder:

git submodule update --init flask-appengine-template

Symlink or copy out everything under flask-appengine-template/src to the main folder. Python modules under 4. Dependencies can be symlinked/copied to the 'lib' folder, the app will pick them up automatically.

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

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

4. Dependencies

Install with Python package manager of choice:

5. Changelog

  • 0.2: Major rewrite, now based on Flask/Werkzeug
  • 0.1: Initial release with Django

6. 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.