hugo-cloak-email

About

This is not a standalone theme. It is a Hugo theme component providing a shortcode: cloakemail to cloak any e-mail or other messaging (xmpp, tg, etc.) or phone (sip, tel, etc.) address from spamming bots.

Usage

1. Add the hugo-cloak-email as a submodule to be able to get upstream changes later git submodule add https://github.com/martignoni/hugo-cloak-email.git themes/hugo-cloak-email
2. Add hugo-cloak-email as the left-most element of the theme list variable in your site's or theme's configuration file config.yaml or config.toml. Example, with config.yaml:

   theme: ["hugo-cloak-email", "my-theme"]
   

   or, with config.toml,

   theme = ["hugo-cloak-email", "my-theme"]
   

3. In your site, use the shortcode, this way:

   {{< cloakemail "john.doe@example.com" >}}
   

   or

   {{< cloakemail address="john.doe@example.com" >}}
   

   or, if you want to specify a protocol and/or a class,

   {{< cloakemail address="john.doe@example.com" protocol="xmpp" class="vip" >}}
   

Credits

Copyright © 2019 onwards, Nicolas Martignoni nicolas@martignoni.net.

Thanks to @mxmehl for ideas and explanations about other protocols and script fingerprinting.

This theme component was possible because of the work done by @danieka in this pull request.