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.contrib.text.Text',
    'tumblelog.contrib.photo.Image',
    'recipes.models.Recipe',
]

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

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

Django 1.4 is required (for list filters), and django.contrib.contenttypes must be installed.

Tumblelog has two dependencies:

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