Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

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

Project description

Blargg!
=======

**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: [bradmontgomery.net](https://bradmontgomery.net) for an example.

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

Features
--------

* 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](https://pypi.python.org/pypi/docutils), markdown (requires
[Markdown](https://pypi.python.org/pypi/Markdown) or plain old HTML.

Installation
------------

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

BLARGG = {
'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::

BLARGG = {
'title': ...,
'description': ...,
'mail2blogger': True,
'mail2blogger_email': 'username.SECRET@blogger.com',
}

To set your Mail2Blogger email address, view your
[Mobile and email](http://www.blogger.com) 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](https://github.com/bradmontgomery/django-blargg/issues/3).

License
-------

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


Contributing
------------

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"?
----------------------

From http://nintendo.wikia.com/wiki/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!

**Blargg**.

Project details


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
django-blargg-0.7.0.tar.gz (15.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page