Metadata-Version: 2.0
Name: django-premailer
Version: 0.2.0
Summary: Django template tag that turns CSS blocks into style attributes using premailer.
Home-page: http://github.com/alexhayes/django-premailer
Author: Alex Hayes
Author-email: alex@alution.com
License: MIT
Keywords: premailer,inline css,django,templatetag,html,lxml,email,mail,style
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.6
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Communications
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Requires-Dist: premailer (==3.0.0)

================
Django Premailer
================

Django template tag that turns CSS blocks into style attributes using premailer_.

.. image:: https://travis-ci.org/alexhayes/django-premailer.png?branch=master
    :target: https://travis-ci.org/alexhayes/django-premailer
    :alt: Build Status

.. image:: https://landscape.io/github/alexhayes/django-premailer/master/landscape.png
    :target: https://landscape.io/github/alexhayes/django-premailer/
    :alt: Code Health

.. image:: https://codecov.io/github/alexhayes/django-premailer/coverage.svg?branch=master
    :target: https://codecov.io/github/alexhayes/django-premailer?branch=master
    :alt: Code Coverage

.. image:: https://readthedocs.org/projects/django-premailer/badge/
    :target: http://django-premailer.readthedocs.org/en/latest/
    :alt: Documentation Status

.. image:: https://img.shields.io/pypi/v/django-premailer.svg
    :target: https://pypi.python.org/pypi/django-premailer
    :alt: Latest Version

.. image:: https://img.shields.io/pypi/pyversions/django-premailer.svg
    :target: https://pypi.python.org/pypi/django-premailer/
    :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/dd/django-premailer.svg
    :target: https://pypi.python.org/pypi/django-premailer/
    :alt: Downloads


Install
-------

.. code-block:: bash

    pip install django-premailer

Add ``django_premailer`` to your ``INSTALLED_APPS``:

.. code-block:: python

    INSTALLED_APPS = (
        '...',
        'django_premailer'
    )


Example Usage
-------------

Simply use the ``premailer`` template tag around HTML where you need inline CSS: 

.. code-block:: html

    {% load premailer %}

    {% premailer "http://example.com" %}
    <html>
    <style type="text/css">
    h1 { border:1px solid black }
    p { color:red;}
    .c {
      background-color: #FF6600;
    }
    .c td {
      background-color: #CCCCCC;
    }
    </style>
    <h1 style="font-weight:bolder">{{ eggs }}</h1>
    <p><a href="/blah/">Hej</a></p>
    <table class="c">
      <tr>
        <td></td>
      </tr>
    </table>
    </html>
    {% endpremailer %}

The rendered template would look as so;

.. code-block:: html

    <html>
    <head></head>
    <body>
        <h1 style="border:1px solid black; font-weight:bolder">Sausage</h1>
        <p style="color:red"><a href="http://example.com/blah/">Hej</a></p>
        <table style="background-color:#F60" bgcolor="#F60">
          <tr>
            <td style="background-color:#CCC" bgcolor="#CCC"></td>
          </tr>
        </table>
    </body>
    </html>


Settings
--------

If you need more control over premailer's init parameters you can define them using ``PREMAILER_OPTIONS``.

For example, in your settings file;

.. code-block:: python

    PREMAILER_OPTIONS = dict(base_url='http://example.com',
                             remove_classes=False)

See https://github.com/peterbe/premailer/blob/master/premailer/premailer.py#L149 for a list of other possible options.

Thanks
------

- Special thanks to http://roi.com.au for supporting this project.
- Thanks to https://github.com/roverdotcom/django-inlinecss for initial inspiration.

Author
------

Alex Hayes <alex@alution.com>


.. _premailer: https://github.com/peterbe/premailer


