Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
================ Django Blog Base ================ A Django application that provides a few utilities useful for implementing basic blog functionality. The application is quite flexible and can be used to implement a blog in a project or as a base for creating a blogging engine. The application is pretty specialized and does not provide any functionality to do comments, trackbacks, tags etc. There are applications and external solutions out there that provide such functionality. Roll a reusable application that includes and configures everything you need if you find yourself creating a lot of blogs that share a set of common functionality. Dependencies ============ Any markup module you wish to use (`markdown`, `textile` or `docutils`). Installation ============ Settings -------- Add the ``blog_base`` to your INSTALLED_APPS:: INSTALLED_APPS = ( ... 'blog_base', ) Create an Entry Model --------------------- Create a model that extends `blog_base.models.BaseEntry`:: from blog_base.models import BaseEntry class DevelopmentEntry(BaseEntry): some_field = ... Register your blog ------------------ Register the model you created in the previous step for use when creating entries. Your project's `urls.py` might be a good place:: from blog_base import blogs blogs.register('development', DevelopmentEntry) (NOTE: You must register your model *before* running `admin.autodiscover()`) URL directives -------------- Get started by adding the following in your projects' `urls.py`:: (r'^blogs/', include('blog_base.urls')), And your blog should now be available at:: /blogs/development/ Configuration ============= `blogs.register()` takes a configuration class as an optional argument. A configuration class works in a similar fashion to a `admin.ModelAdmin` class; you extend a basic configuration and override any attributes to achieve desired behaviour. Example:: from blog_base.blogs import BlogConfiguration class DevelopmentConfiguration(BlogConfiguration): entry_list_template_name = 'myblog/entry_list.html' feed_title = 'Feed for my blog' And register as such:: blogs.register('development', DevelopmentEntry, DevelopmentConfiguration) See ``blog_base.blogs.BlogConfiguration`` for documentation of all available attributes. TODO ==== I'm not entirely satisfied with some implementation details. The application will probably see quite a few changes when I have time to play with it. * Add regression tests and work a little more on the example application. * Consider alternative URL implementations. Prefixing all URLs with something like '^/blogs/' is far from ideal in many situations (especially not suitable for single-blog implementations). It's easy enough to write new routing based on the one provided by the application, or to simply use an empty pattern ('^'), but there are better solutions to this I am sure. * Friendly error message when selecting a markup option that has not been installed. * Better support for configuring the admin interface. * Improve feed-configuration. * Must configurations really be registered before running `admin.autodiscover()`? Is that really a problem? Look into it. * Maybe not send the entire configuration instance in every view. * Support for alternative content types might fall in the scope of this application (think pygments etc). * Consider possible performance improvements, if just for a few seconds. * Maybe split BaseEntry into a minimal core and a few special abstract models?