Metadata-Version: 1.1
Name: django-blargg
Version: 0.7.0
Summary: A minimal, admin-powered, django blogging app with a fun name.
Home-page: https://github.com/bradmontgomery/django-blargg
Author: Brad Montgomery
Author-email: brad@bradmontgomery.net
License: MIT
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**.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.1
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
