Email protection liquid filter for Jekyll
Latest commit 8844902 Feb 28, 2016 @vwochnik fix #1
Failed to load latest commit information.
.bundle preparation for tests Nov 20, 2015
spec structure refactoring Nov 22, 2015
.rspec preparation for tests Nov 20, 2015
Gemfile preparation for tests Nov 20, 2015 first version of plugin Nov 20, 2015
jekyll-email-protect.gemspec fix gemfile Nov 22, 2015

Jekyll Email Protect Gem Version

Email protection liquid filter for Jekyll

Jekyll Email Protect is an email protection liquid filter which can be used to obfuscate mailto: links to protect an email address from span bots.


This plugin is available as a RubyGem.

Add this line to your application's Gemfile:

gem 'jekyll-email-protect'

And then execute the bundle command to install the gem.

Alternatively, you can also manually install the gem using the following command:

$ gem install jekyll-email-protect

After the plugin has been installed successfully, add the following lines to your _config.yml in order to tell Jekyll to use the plugin:

- jekyll-email-protect

Getting Started

In your markup, simply use the encode_email liquid filter made available through this plugin:

{{ '' | encode_email }}

The above code will yield %65%78%61%6D%70%6C%65@%65%78%61%6D%70%6C%65.%63%6F%6D. Only use this filter within the href attribute of a given link.


The following example shows how this plugin can be used to protect the site's email address:

<a href="mailto:{{ | encode_email }}" title="Contact me">Contact me</a>


Fork this repository, make your changes and then issue a pull request. If you find bugs or have new ideas that you do not want to implement yourself, file a bug report.


Copyright (c) 2015 Vincent Wochnik.

License: MIT