0.0
No commit activity in last 3 years
No release in over 3 years
Miscellaneous improvements and fixes to Alex Dunae's Premailer gem
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0.9.0
>= 0.8.1
>= 4.1.0
>= 0.2.0
 Project Readme

premailer-plus

Misc. improvements by: Mike Green (mike.is.green@gmail.com)
Original Premailer By: Alex Dunae (http://www.dunae.ca)

Check out the Premailer web application at http://code.dunae.ca/premailer.web

Background

Premailer Plus is my set of additions and corrections to Alex Dunae’s excellent Premailer application. Premailer is “Preflight for HTML email”, i.e. it takes your HTML code, and makes it compatible with most email clients. Email clients aren’t like web browsers; their support for CSS is spotty and erratic, and they don’t always render your code the way you’d expect. Premailer takes your CSS and moves it inline to each matched HTML element, and it displays warnings if you use code that’s not well supported by email clients. Campaign Monitor sponsors and uses Premailer to get your code ready for mass emails. It’s a one of a kind, indispensible service, but I’ve always had a few gripes about the Premailer Rubygem, so I finally decided to fork the code and apply my fixes and improvements.

Problems with “Premailer Classic”

I downloaded the Premailer gem so that I could rock the excellence of Premailer on my Mac instead of having to rely on an external service. There’s even a TextMate bundle available that lets you Premailer you code right in the editor. But when I downloaded it, I found one glaring problem: When you run Premailer from the command line, it throws an error when you give it a local file instead of a URL. Kind of defeats the purpose.

Improvements in Premailer Plus

  • I fixed the command line script so that it no longer throws errors when you feed it a local file
  • New option to shorten the URLs of links in your plain text version
  • More to come!

Installation

The easiest way to install Premailer Plus is to run the following code on your OS X or Linux terminal (should work on Windows too, but I’m not sure):

	$ sudo gem install mikedamage-premailer-plus

You can also clone this repository and run rake build from the project root. Then run sudo gem install ./pkg/premailer-plus*.gem

Dependencies

Copyright

Since I only improved Premailer’s handling of local files and gave it the ability to shorten URL’s, the copyright to this code is still held by Alex Dunae. I am only modifying and redistributing his code in compliance with the terms of Premailer’s license.