jekyll-kw-shorten

A jekyll plugin which can shorten long numbers, e.g. 1000 ➜ 1K or 1000000 ➜ 1M.

The project jekyll-kw-shorten is a plug-in for a jekyll static page blog. It can be used as filter and as tag.

It is published on rubygems.org, the source code is hosted on GitHub.

Use the filter {{ 1234 | shorten }} or the tag {% shorten 1234 %} inside your markdown blog post file to get 1.2 K.

The plug-in supports

• positiv numbers
• negativ numbers with leading - or - .
• float numbers (when multiple dots are in the text only the part to the first will be taken)
• Text with no numbers inside will simply echoed
• Text with numbers, will be reduced to just the digits
• Show a rocket ∞ 🚀 for very huge values (>= 1000000000000)
• Float numbers will be rounded

HINTS:

• The filter {{ MyText | shorten }} will show nothing (empty string). The filter "thinks" the MyText is a variable (with the value nil). Numbers can be used with and without quotes. Text must be wrapped in quotes.
• The filter {{ - 44 | shorten }} will show nothing (empty string). The filter tries to parse the - as first part, not the number behind.

Add jekyll-kw-shorten plugin in your Gemfile inside the jekyll_plugins group.

group :jekyll_plugins do
  ...
  gem "jekyll-kw-shorten"
  ...
end

Run bundle install to install the gem and update the Gemfile.lock.

Add jekyll-kw-shorten to the plugins section in your site's _config.yml. Then configure your plug-in.

plugins:
  - jekyll-kw-shorten

Add the setting to your _config.yml file. Details you can find in the documentation. The name of the group is jekyll-kw-shorten.

• shorten_gt3_digit will be used for numbers between 1000 and 999999. Default is ' K'.
• shorten_gt6_digit will be used for numbers between 1000000 and 999999999. Default is ' M'.
• shorten_gt9_digit will be used for numbers between 1000000000 and 999999999999. Default is ' B'.

...
jekyll-kw-shorten:
  shorten_gt3_digit: ' K'
  shorten_gt6_digit: ' M'
  shorten_gt9_digit: ' B'
...

When the config values are omit then the default values are used.

Run linting

bundle exec rubocop

Run tests

bundle exec rake test