Fork me on Github

Premailer Plus

Based on Premailer by Alex Dunae
By Mike Green ()

About Premailer Plus

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.

Installing

Via RubyGems

Since Premailer Plus is distributed as a RubyGem, the easiest way to install it is via the gem command:

$ gem sources -a http://gems.github.com
$ gem install mikedamage-premailer-plus

Download The Code

You can download a Zip, Tar, or Gem file from the Downloads section below. If you download the Gem file, use the instructions above, substituting the Gem file's name for "mikedamage-premailer-plus".

If you download a Zip or Tar archive, decompress it and cd into the folder it creates. Then run:

$ rake build
$ cd pkg
$ gem install <newly_built_gem_filename>

Clone From Github

You can get the very latest, bleeding edge version of Premailer Plus from Github if you use Git. Just clone it like so:

$ git clone git://github.com/mikedamage/premailer-plus.git

Once you clone it, follow the installation instructions for Zip and Tar files above.

Each release in the Git repository is tagged, so if you know your way around Git you can checkout and build whatever version you want.

Usage

Downloads

Contribute!

License

Premailer Plus is released under the terms of Premailer's original license.

Premailer License

Copyright © 2007 Alex Dunae

Premailer is copyrighted free software by Alex Dunae (http://dunae.ca). You can redistribute it and/or modify it under the conditions below:

  1. You may make and give away verbatim copies of the source form of the software without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers.
  2. You may modify your copy of the software in any way, provided that you do at least ONE of the following:
    • place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to the internet or an equivalent medium, or by allowing the author to include your modifications in the software.
    • use the modified software only within your corporation or organization.
    • rename any non-standard executables so the names do not conflict with standard executables, which must also be provided.
    • make other distribution arrangements with the author.
  3. You may modify and include the part of the software into any other software (possibly commercial) as long as clear acknowledgement and a link back to the original software (http://code.dunae.ca/premailer.web/) is provided.
  4. The scripts and library files supplied as input to or produced as output from the software do not automatically fall under the copyright of the software, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this software.
  5. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.