django-blogdor

All code is under a BSD-style license, see LICENSE for details.

Source: http://github.com/sunlightlabs/django-blogdor/

Requirements

python >= 2.5

django >= r10650

tagging >= r155

Installation

To install run

python setup.py install

which will install the application into python's site-packages directory.

Add to INSTALLED_APPS:

'django.contrib.comments',
'django.contrib.markup',
'tagging',
'blogdor',

Features

Settings

All settings are optional. The example values are the defaults for each setting.

General Settings

The default permalink structure is year/slug. A setting of True will use a WordPress compatible permalink structure of year/month/day/slug.

BLOGDOR_WP_PERMALINKS = False

The number of posts to display per list page.

BLOGDOR_POSTS_PER_PAGE = 10

The default year archive page will display a list of months in the year and links to the month archive pages. A setting of True will display links to the posts as well. If there are a large number of posts per year, this page could take quite some time to render if set to True.

BLOGDOR_YEAR_POST_LIST = False

Some sites have many users, most of whom are not allowed to post on the blog.

BLOGDOR_AUTHOR_GROUP = None

Feed Settings

Use the boring old default feeds if set to True. If False, you will have to specify the feed URLs yourself, though you may use or extend the Feed classes provided by blogdor (blogdor.feeds.LatestPosts, blogdor.feeds.LatestComments, blogdor.feeds.LatestForTag).

BLOGDOR_ENABLE_FEEDS = True

Time-to-live for the feeds. Valid only if BLOGDOR_DEFAULT_FEEDS is set to True.

BLOGDOR_FEED_TTL = 120

Number if items to display in feeds. Valid only if BLOGDOR_DEFAULT_FEEDS is set to True.

BLOGDOR_ITEMS_PER_FEED = 10

Email Settings

Blogdor will sometimes send emails to Post authors. If not specified in settings, %s is replaced by Site.objects.current_site().domain.

BLOGDOR_FROM_EMAIL = 'bounce@%s'

Markup Settings

Blogdor uses James Turk's django-markupfield to allow users to select different forms of markup with which their posts are to be rendered. The type of markup can be selected on a per-post basis, but the default is Markdown. To override the default, set BLOGDOR_DEFAULT_MARKUP.

BLOGDOR_DEFAULT_MARKUP = 'markdown'

Refer to MarkupField documentation for the available markup types.

Other Settings

Set to your Akismet key if you would like to use Akismet filtering on comments.

AKISMET_KEY = ''

URL to a default image to show if no Gravatar is found for the email address. If this value is not specified, Gravatar will provide a default image for you.