Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Simple reStructuredText blogging for Django

Project Description


Chalk is a basic blogging app for Django which lets you write posts using reStructuredText. It was written for personal use and I’ll be adding features as I need them but if you end up finding it useful and would like to see anything added then I’d like to hear from you. Either email me at or open an issue in the Bitbucket repo.

Installing django-chalk

There are several ways to install this application.

Using pip or easy_install

Pip is the recommended package-installation tool for Python. To install django-chalk with pip, use the command:

pip install django-chalk

If you prefer to use easy_install then replace pip with easy_install in the above command.

To install the latest in-development version (which may not be stable) directly from the project’s Git repository you can use the command:

pip install -e git+

Using setuptools

Download the package source code or distribution tarball and then run the following command in the django-chalk directory:

python install

Configuring django-chalk

Settings and models

Add chalk to the INSTALLED_APPS setting of your project. Once you’ve done this you can create chalk’s database tables using syncdb.

Setting up URLs

All the URLs which chalk needs are set in chalk.urls so you can simply include that file in your project’s root URLconf. For example, to add chalk to your project under the path /blog/ you would add the following to your root URLconf:

(r'^blog', include('chalk.urls')),

With this setup chalk all articles are listed at the URL /blog/ and individual articles can be found at /blog/[article_slug]/


Chalk includes bare-bones examples of the templates it needs but these may not work with your project’s template structure and even if they do you’ll probably want to override them. The templates to override are chalk/article_list.html which displays a list of all articles and chalk/article_detail.html which displays individual articles.

Reporting problems or suggesting improvements

Please use the issue tracker at the project’s Bitbucket repo

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(15.1 kB) Copy SHA256 Hash SHA256
Source Aug 27, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting