Jekyll-Aspect-Ratio

enables the use of a custom Liquid tag {% aspectratio filepath %}, to find the aspect ratio of an image or video file.

Example use cases

• Specify the flex-grow value of an item so that a series of items of different aspect ratios can fill up one row, all being the same height
• Sort or separate items by aspect ratio, to display horizontal vs vertical videos together (aspect ratio <1 is a portrait item, >1 is landscape)

Installation

# via ruby-gems
- gem install jekyll-aspect-ratio
# or via bundler
- bundle add jekyll-aspect-ratio

Jekyll integration

Add the gem to your plugins inside _config.yml:

plugins:
- jekyll-aspect-ratio

Supported file types

This plugin uses , so supports all . This means it's capable of handling both videos and images.

Usage

{% assign filepath = "assets/media/2020-05-10/image1.jpg" }
{% aspectratio filepath %} >>> 1.33
{% aspectratio "assets/media/2020-05-10/image2.jpg" } >>> 0.56
{% aspectratio /assets/media/2020-05-10/video1.mp4 } >>> 1.77
{% aspectratio "assets/media/2020-05-10/not-a-real-file.jpg" } >>> 0