Emoji for Jekyll
Seamlessly enable emoji for Jekyll.
gem install emoji_for_jekyll
emoji_for_jekyllto the list of gems in
- See beautiful emoji!
This plugin (and as a matter of fact, most Jekyll plugins) do not work with GitHub Pages as GitHub (understandably) do not allow arbitrary code to be executed on their servers. As a result, only selected plugins work with GitHub pages.
Here are my suggestions if you are using GitHub Pages:
Build your site locally and push the content of
Whitelist and blacklist
You can also whitelist or blacklist certain emojis. On the posts or pages that you want to whitelist or blacklist certain emojis, add
emoji-blacklist follow by a list of emojis without the colons to the front matter. For example:
emoji-whitelist: - bowtie - blush
emoji-blacklist: - smile
emoji-blacklist are declared, the effect will be the same as when only the whitelist is declared.
You may choose to disable this plugin for certain posts or pages by adding
emoji: false to the front matter of these posts and pages.
If, for some reason, you want to disable this plugin for the entire site, you can either remove
_plugins, or just add
emoji: false to
Emojify front-matter items
If you need to emojify certain items in your front-matter, like
caption that is needed for some templates, you can do so by setting
_config.yml. This setting is optional and expects an array:
emoji-additional-keys: ["title", "caption"]
By default the images are sourced from GitHub CDN but should you want to use other images you can by choosing a directory with the setting
_config.yml. For example:
Images copied into this directory will be added the whitelist. E.g.:
custom.png would whitelist
:custom:. Any images with the same name as the emoji list will overwrite the default GitHub emoji image.
Updating Emoji for Jekyll
Updating Emoji for Jekyll is very easy:
gem update emoji_for_jekyll