Skip to main content

A web log for Django.

Project description

A [Django](http://www.djangoproject.com/) web log application.

Genesis

This application began life as part of [Nathan Borror](http://nathanborror.com/)’s [django-basic-apps](https://github.com/nathanborror/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](http://montylounge.com/)’s [django-mingus](https://github.com/montylounge/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](https://github.com/pigmonkey/django-media) and [django-inlineobjects](https://github.com/pigmonkey/django-inlineobjects)), deleted the rest, and renamed the blog.

Thus, django-[vellum](https://en.wikipedia.org/wiki/Vellum).

Features

### Wordpress Import

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

### Disqus

[Disqus](https://disqus.com/) 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](http://daringfireball.net/projects/markdown/) is recommended).

If Markdown is used, an enjoyable writing experience is provided by [django-wmd](https://github.com/pigmonkey/django-wmd/).

Requirements

### Suggested

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

Installation

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 setup.py install

Setup

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

Questions

If you have any questions, or encounter any issues, email me at [pm@pig-monkey.com](mailto:pm@pig-monkey.com).

Full documentation is coming, I promise!

Project details


Release history Release notifications

History Node

1.4.2

History Node

1.4.1

History Node

1.4

History Node

1.3

This version
History Node

1.2

History Node

1.1

History Node

1.0

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_vellum-1.2-py2.7.egg (46.9 kB) Copy SHA256 hash SHA256 Egg 2.7 Sep 16, 2012
django-vellum-1.2.tar.gz (19.2 kB) Copy SHA256 hash SHA256 Source None Sep 16, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page