Skip to content
This repository has been archived by the owner on Dec 12, 2022. It is now read-only.


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


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!



because the world needs another django-powered blog app!








No packages published