tas-gulp-email-builder

Uses Email Builder to inline css, send email tests, and send tests to Litmus


Keywords
gulpplugin, inline, email, css, litmus
License
Other
Install
npm install tas-gulp-email-builder@1.0.1

Documentation

tas-gulp-email-builder

Join the chat at https://gitter.im/Email-builder/gulp-email-builder Build Status

Uses Email Builder to inline css into HTML tags, send tests to Litmus, and send test emails to yourself.

Example:

<!DOCTYPE html>
<html>
<head>
  <!-- styles will be inlined -->
  <link rel="stylesheet" type="text/css" href="../css/styles.css">

  <!-- styles will be embedded -->
  <link rel="stylesheet" type="text/css" href="../css/otherStyles.css" data-embed>

  <!-- link tag will be preserved and styles will not be inlined or embedded -->
  <link href='http://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css' data-embed-ignore>

  <!-- styles will be inlined -->
  <style>
    p { color: red; }
  </style>

  <!-- styles will be embedded -->
  <style data-embed>
    h1 { color: black; }
  </style>
</head>
<body>
  <h1>Heading</h1>
  <p>Body</p>
</body>
</html>

You can see an example setups below

Getting Started

Install this gulp plugin next to your project's gulpfile with: npm install gulp-email-builder

Then add this line to your project's gulp.js gulp:

var emailBuilder = require('tas-gulp-email-builder');

Documentation

Place this in your gulp file.

  gulp.task('emailBuilder', function() {
    return gulp.src(['./example/html/*.html'])
      .pipe(emailBuilder(options).build())
      .pipe(gulp.dest('./example/dist/'));
  });

Other available methods

Besides the main emailBuilder(options).build() function, the email-builder-core methods are exposed so users can use them on an individual basis.

  • emailBuilder(options).inlineCss()
  • emailBuilder(options).sendEmailTest()
  • emailBuilder(options).sendLitmusTest()

Example

...
.pipe(emailBuilder(options).sendEmailTest())
...

Options

View Email Builder options for all available options.

Complete Example

var EmailBuilder = require('tas-gulp-email-builder');

var options = { encodeSpecialChars: true }
var builder = EmailBuilder(options);

gulp.task('emailBuilder', function() {
  return gulp.src(['./example/html/*.html'])
    .pipe(builder.build())
    .pipe(gulp.dest('./example/dist/'));
});

Further Reading

Release History

License

MIT