Skip to main content

A minimal, admin-powered, django blogging app with a fun name.

Project description


**yet another** Django-powered blog. The goal of this app is to provide a
minimalistic (in both number of features and code) tool for publishing a
mostly-text blog. Shameless plug: []( for an example.

This app provides a fairly simple `Entry` model, and a light-weight `Tag` model.


* Support for `Site`
* Simple content tagging
* RSS and Atom Feeds
* Sitemap support
* Automatic cross-posting to Blogger (see below)
* Support authoring content in reStructured Text (requires
[docutils](, markdown (requires
[Markdown]( or plain old HTML.


1. Install with `pip install django-blargg`
2. Add `blargg` to your `INSTALLED_APPS`
3. Configure your Root URLconf: `path('blog/', include('blargg.urls', namespace='blargg'))`
4. Customize your templates. There are some sample templates under
`blargg/templates/blargg`, but you'll want to override these in your project.
5. Add a `BLARGG` setting dict that contains the title and description to be
used in your blog's RSS feeds (see below).
6. (Optinally) enable Mail2Blogger (see below)

### Sample BLARGG settings

'title': 'Awesome blog',
'description': 'Entries from an awesome blog',

Mail2Blogger Support

This app supports cross-posting to Blogger via email. By default, this setting
is disabled. To enable Mail2Blogger, include the following settings::

'title': ...,
'description': ...,
'mail2blogger': True,
'mail2blogger_email': '',

To set your Mail2Blogger email address, view your
[Mobile and email]( settings. Entries that are
cross-posted to Blogger will automatically include a link back to the original
site (provided that you've got the `django.contrib.sites` app installed and
configured correctly).

**Warning**: *mail2blogger* appears to remove extra whitespace from your content
which breaks things in a `<pre>` or `<code>` blocks. If you know how to
prevent this, [please let me know](


This code is distributed under the terms of the MIT license. See the `LICENSE.txt` file.


Feel free to report any issues or (better yet) pull requests for bug fixes!
There's a `requirements.txt` file in this repo to help you get all the
dependencies you'll likely need (for python3).

Why the name "Blargg"?


A Blargg is a large red dragon that lives in lava and appears in Super Mario
World. When Mario goes across a lava pit on a pile of skulls occasionally
the eyes of a Blargg will appear and then itself will try to eat Mario. They
are found mostly in the Vanilla Dome. Strangely, they have one lazy eye.

Other than that, *Blargg* is really fun to say out loud. Especially if you use
a *Pirate Voice*. Go ahead, try it!


Project details

Download files

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

Source Distribution

django-blargg-0.7.0.tar.gz (15.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page