skip to navigation
skip to content

django-vellum 1.2

A web log for Django.

Latest Version: 1.4.2

A [Django]( web log application.


This application began life as part of [Nathan Borror](’s [django-basic-apps](, a collection of simple prebuilt Django applications.

When I first decided I wanted to move to a Django-based blog, I looked around to see if there were any existing projects I could use. There was certainly no shortage of blog applications, but none of them were exactly what I was looking for. Nathan’s basic blog was close, but, as the name implies, very basic. [Kevin Fricovsky](’s [django-mingus](, which is itself built on top of Nathan’s basic blog, appealed to me the most, but still had aspects that I did not like. So I decided to create my own.

In true open source fashion, I forked django-basic-apps. It provided an excellent framework to work from – had I started from scratch, I would have ended up recreating a lot of what Nathan had already done. With that fork, along with some ideas inspired by django-mingus and Wordpress, I was able to craft a blog application that suited me perfectly. I think it’s pretty nice – and it turns out it suits some other people pretty well, too!

The only thing I did not like about it was that the blog was part of a larger collection of Django applications, most of which I did not use. I am happy to put my name on the blog, but I did not want to maintain or vouch for the numerous other apps. So, I spun off the two other applications that I did use ([django-media]( and [django-inlineobjects](, deleted the rest, and renamed the blog.

Thus, django-[vellum](


### Wordpress Import

A management script is included to import blog posts from a Wordpress-generated XML file. For more information, run ./ wordpress_import.

### Disqus

[Disqus]( comments are supported (and recommended).

### Excerpts

An author can manually specify content to use as the tease of a post. If they choose not to do this, they may instead choose to display an excerpt which is automatically generated by truncating the post body.

### Markup

Posts can be written in traditional HTML, plaintext, or any number of markup languages ([Markdown]( is recommended).

If Markdown is used, an enjoyable writing experience is provided by [django-wmd](


### Suggested

The following packages are not required, but are suggested to take full advantage of django-vellum.


django-vellum is available on PyPI and can be installed with PIP.

pip install django-vellum

Alternatively, you may download the source and install it.

python install


  1. Add vellum to your settings.INSTALLED_APPS.
  2. Add vellum.context_processors.blog_settings to your settings.TEMPLATE_CONTEXT_PROCESSORS.


If you have any questions, or encounter any issues, email me at [](

Full documentation is coming, I promise!

File Type Py Version Uploaded on Size
django-vellum-1.2.tar.gz (md5, pgp) Source 2012-09-16 18KB
django_vellum-1.2-py2.7.egg (md5, pgp) Python Egg 2.7 2012-09-16 45KB