Skip to main content

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

Project description

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

Build Status Code Health Code Coverage Documentation Status Latest Version Supported Python versions Downloads

Install

pip install django-premailer

Add django_premailer to your INSTALLED_APPS:

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

Example Usage

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

{% 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;

<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;

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

Author

Alex Hayes <alex@alution.com>

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-premailer-0.2.0.tar.gz (880.1 kB view details)

Uploaded Source

Built Distribution

django_premailer-0.2.0-py2.py3-none-any.whl (10.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-premailer-0.2.0.tar.gz.

File metadata

File hashes

Hashes for django-premailer-0.2.0.tar.gz
Algorithm Hash digest
SHA256 561b8a10bd1673794d55830c1a6479cfdfdb61d314f24f5ebc5685cd32023df6
MD5 cf9a15a3765dcc3fc237db04acdcb487
BLAKE2b-256 4b668235bcabee77e991d464153b81381d9511d32dff4832ee387486bfaf4378

See more details on using hashes here.

File details

Details for the file django_premailer-0.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_premailer-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 307e386e3c4b3e0d030f172c2af84eb6c64724b36f568046b4515be3f3fed357
MD5 c64ad0020f457a071ca93a3d7da28dea
BLAKE2b-256 8a1e4424f664eff19fc1d448804af7a3158a4e0e3b2dd23d2bebcf6341a8220c

See more details on using hashes here.

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