The project is in a healthy, maintained state
A collection of opinionated plugins for Jekyll.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.6.0
>= 12.3.3
~> 3.11
~> 1.25
~> 0.21

Runtime

~> 4.0
~> 1.13
 Project Readme

Jekyll Miscellaneous

Gem Version codecov

A collection of opinionated plugins for Jekyll.

How to install

Install the gem:

gem install jekyll_miscellaneous

Or add it to your Gemfile. You can use bundle add jekyll_miscellaneous.

Then use the plugin in your Jekyll's _config.yml file.

plugins:
  - jekyll_miscellaneous

How to use

This gem includes multiple Jekyll or Liquid plugins that you can use immediately without further configuration.

  • Tags
    • YouTube
  • Filters
    • Base64 Encode
    • Base64 Decode
    • Hash Color
    • Regex Replace
    • Clean URLs
    • Truncate
    • URI Encode
  • Hooks
    • External Links
    • Mark

More to come.

YouTube

Given:

{% youtube dQw4w9WgXcQ %}

Will output:

<div class="youtube-container">
  <iframe src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ"></iframe>
</div>

Base64 Encode

Given:

{% 'Hello, World!' | base64_encode %}

Will output:

SGVsbG8sIFdvcmxkIQ==

Base64 Decode

Given:

{% 'SGVsbG8sIFdvcmxkIQ==' | base64_decode %}

Will output:

Hello, World!

Hash Color

Given:

{% 'Hello, World!' | hash_color %}

Will output:

hsl(349, 100%, 90%)

Regex Replace

Given:

{% 'Hello, World!' | regex_replace '$Hello', 'Goodbye' %}

Will output:

Goodbye, World!

Clean URLs

Given:

{% 'Hello, http://example.com World!' | clean_urls %}

Will output:

Hello, World!

Truncate

Given:

{% 'Hello, World!' | truncate 10 %}
{% 'Hello, World!' | truncate 10 ',' %}
{% 'Hello, World!' | truncate 10 ',' '!' %}

Will output:

Hello, ...
Hello...
Hello!

URI encode

Given:

{% 'Hello, World!' | uri_encode %}

Will output:

Hello%2C%20World%21

External links

With the configuration:

base_url: https://kinduff.com

Given:

<p>
  Link to the
  <a href="https://example.com">example</a>.
</p>

Will output:

<p>
  Link to the
  <a href="https://example.com" rel="external" target="_blank">example ⧉</a>.
</p>

More in the documentation.

Mark

Given:

Hello, ==World==!

Will output:

<p>Hello, <mark>World</mark>!</p>

Contributing

  1. Fork it (https://github.com/kinduff/jekyll_miscellaneous/fork).
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am "Add some feature").
  4. Push to the branch (git push origin my-new-feature).
  5. Create new Pull Request.