About
Inlining CSS is necessary for email generation and sending but is currently a surprisingly large hassle.
This library aims to make it a breeze in the Django template language.
Usage
Step 1: Dependencies
- BeautifulSoup
- cssutils
- Python 3.6+
- Django 2.2+
Step 2: Install django_inlinecss
Add django_inlinecss to your settings.py:
INSTALLED_APPS = (
'django.contrib.auth',
'django.contrib.webdesign',
'django.contrib.contenttypes',
'...',
'...',
'...',
'django_inlinecss')Step 3: Use the templatetag
- Place your CSS file somewhere staticfiles can find it
- Create your template:
{% load inlinecss %}
{% inlinecss "css/extra-padding.css" %}
<html>
<body>
<div class='lots-o-padding'>
Something in need of styling.
</div>
</body>
</html>
{% endinlinecss %}Step 4: Prepare to be Wowed
<html>
<body>
<div style="padding-left: 10px; padding-right: 10px; padding-top: 10px;" class="lots-o-padding">
Something in need of styling.
</div>
</body>
</html>Acknowledgements
This is a fork of django-inlinecss, with updates for newer versions of Python and Django.
Thanks to Tanner Netterville for his efforts on Pynliner.
Thanks to Thomas Yip for his unit tests on the soupselect module. These tests
helped on getting the core CSS2 selectors to work.
License
MIT license. See LICENSE.md for more detail.
