Installation¶

Installing tumblelog is simple with pip.

$ pip install django-tumblelog

Quickstart¶

Add tumblelog to INSTALLED APPS in your settings module:

INSTALLED_APPS = [
    'django.contrib.contenttypes',
    ...
    'tumblelog',
]

Create the necessary database tables, using either syncdb or migrate (if using South).

$ python manage.py syncdb
$ python manage.py migrate tumblelog

Add a TUMBLELOG_POST_TYPES setting to your settings module, e.g.

TUMBLELOG_POST_TYPES = [
    'tumblelog.Text',
    'tumblelog.Image',
    'recipes.Recipe',
]

You may add additional post typesTo further customize tumblelog, you may want to add additional settings.

Finally, include the tumblelog URLconf to your urls module. The regex may be modified as you wish, though the tumblelog namespace must be maintained.

url(r'^tumblelog/', include('tumblelog.urls', namespace='tumblelog')),

Requirements¶

Django 1.4 is required (for list filters), and three contrib modules must be installed: django.contrib.admin, django.contrib.auth, and django.contrib.contenttypes.

Dependencies¶

Tumblelog has two dependencies:

python-oembed 0.2.1
The latest version of the Python Imaging Library

Source Code¶

tumblelog is developed on GitHub, where you can fork the repository, browse the code, and report issues.

You can use pip to install the bleeding-edge code from the repository:

$ pip install -e git+https://github.com/chuckharmston/django-tumblelog.git#egg=django-tumblelog

Alternatively, you can download a tarball or clone the repository:

$ git clone git://github.com/chuckharmston/django-tumblelog

And install using setup.py:

$ python setup.py install

Navigation