Django template tag that turns CSS blocks into style attributes using premailer.
Project description
# Django Premailer
Django template tag that turns CSS blocks into style attributes using [premailer](https://github.com/peterbe/premailer).
## Install
```bash
pip install django-premailer
```
Add ```django_premailer``` to your ```INSTALLED_APPS```:
```python
INSTALLED_APPS = (
'...',
'django_premailer')
```
## Example Usage
Simply use the ```premailer``` template tag around HTML where you need inline CSS:
```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;
```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;
```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, but chances are you won't need to set any of these.
## 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>
Django template tag that turns CSS blocks into style attributes using [premailer](https://github.com/peterbe/premailer).
## Install
```bash
pip install django-premailer
```
Add ```django_premailer``` to your ```INSTALLED_APPS```:
```python
INSTALLED_APPS = (
'...',
'django_premailer')
```
## Example Usage
Simply use the ```premailer``` template tag around HTML where you need inline CSS:
```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;
```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;
```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, but chances are you won't need to set any of these.
## 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>
Project details
Release history Release notifications | RSS feed
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.1.0.tar.gz
(4.2 kB
view hashes)
Built Distribution
Close
Hashes for django_premailer-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 37c795cc1665ffc26895b1b918ea911025b0fa521227d4ca039fe2e7935e2992 |
|
MD5 | 115de8dcd946f0b3ddbf7dacdf4c42a2 |
|
BLAKE2b-256 | cd8a2b1848659d3032ad2cbdcb43e36bdcbfee4a226f4bf7386e2b62f082ebf5 |