Code Monkey home page Code Monkey logo

bambu-blog's Introduction

Bambu Blog

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).

About Bambu Tools 2.0

This is part of a toolset called Bambu Tools. It's being moved from a namespace of bambu to its own 'root-level' package, along with all the other tools in the set. If you're upgrading from a version prior to 2.0, please make sure to update your code to use bambu_blog rather than bambu.blog.

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')),
)

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.

Better with Bootstrap

This package, among most in the Bambu toolset is designed to work with Bambu Bootstrap, a collection of flexible templates designed for web apps based on the Twitter Bootstrap framework. It's not a package requirement, but it'll mean the template structure and the context variables exposed by the view makes a little more sense.

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.

bambu-blog's People

Stargazers

 avatar

Watchers

 avatar  avatar

Forkers

cash2one

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.