Skip to main content
Help us improve Python packaging – donate today!

A simple set of models for a basic blog, with some tools for custom-designed blog post writing

Project Description

A simple set of models for a basic blog, with some tools for custom-designed blog post writing

About Bambu Blog

Bambu Blog was originally intended as a simple blogging tool for web apps, that allowed developers to quickly setup a blog for their app based on a common Bootstrap template, without needing to manage another site and set of user accounts. It used Markdown to render text-only copy, and Bambu Attachments to handle uploading images and other media.

It’s grown a little since then, and now supports either the MarkItUp or TinyMCE editors (just install the Django app you want and Bambu Blog will detect it and apply the appropriate class names to the main body textbox).

Installation

Install the package via Pip:

pip install bambu-blog

Add it to your INSTALLED_APPS list:

INSTALLED_APPS = (
    ...
    'bambu.blog'
)

Add bambu.blog.urls to your URLconf:

urlpatterns = patterns('',
    ...
    url(r'^blog/', include('bambu.blog.urls')),
)

Sync the database

Run manage.py syncdb or manage.py migrate to setup the database tables.

Basic usage

The blog uses a number of templates. All of the important ones extend blog/base.html, so you should start by overriding that template to set it up how you like it. The naming convention used throughout the Bambu collection of apps designates the main content area via the Jinja block form_content. A block is already defined called sidebar, so you can either place HTML in there or override blog/sidebar.inc.html.

Add a blog post via the admin area of your site. As you’re logged in as a staff member you don’t have to publish the blog post to be able to see it on the site once saved. View the blog post index at /blog/.

Override the blog/post.html template to tweak the display of the blog post.

Todo

  • Prepare for internationalisation
  • Write more tests

Documentation

Full documentation can be found at ReadTheDocs.

Questions or suggestions?

Find me on Twitter (@iamsteadman) or visit my blog.

Release history Release notifications

History Node

3.3.1

History Node

3.3

History Node

3.2.2

History Node

3.2.1

History Node

3.2

History Node

3.1

History Node

3.0

History Node

3.0a0

History Node

2.1

History Node

2.0.1

History Node

2.0

History Node

0.3

This version
History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1

History Node

0.0.2

History Node

0.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
bambu-blog-0.2.4.tar.gz (25.2 kB) Copy SHA256 hash SHA256 Source None Apr 26, 2014

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