Contents

---
sort: 7
---

# Cropping

## Crop & Media Crop

_Format:_

```yaml
    crop: (aspect ratio)
    media_crop:
      (media_preset): (aspect ratio)
      (media_preset): (aspect ratio)
      (...)
```

_Example:_

```yaml
    crop: '16:9'
    media_crop:
      tablet: '3:2'
      mobile: '1:1'
```

Crop aspect ratio, given either generally or for specific media presets. The
hierarchy is: `tag argument` > `media_crop:` > `crop:`.

This setting accepts the same arguments as the `crop` 
[tag parameter]({{ site.baseurl }}/users/liquid_tag/argument_reference/crop).

## Keep & Media Keep

```yaml
    keep: (measure)
    media_keep:
      (media_preset): (measure)
      (media_preset): (measure)
      (...)
```

_Example:_

```yaml
    keep: attention
    media_gravity:
      tablet: entropy
      mobile: center
```

Which part of the image to keep when cropping, given either generally or for specific media presets.
The hierarchy is: `tag argument` > `media_keep:` > `keep:` > `attention` (default).

This setting accepts the same arguments as the `keep` [tag parameter]({{ site.baseurl
}}/users/liquid_tag/argument_reference/crop):
* `center` or `centre`
* `attention`
* `entropy`

Version data entries

8 entries across 8 versions & 1 rubygems

Version	Path
jekyll_picture_tag-2.1.2	docs/users/presets/cropping.md
jekyll_picture_tag-2.1.1	docs/users/presets/cropping.md
jekyll_picture_tag-2.1.0	docs/users/presets/cropping.md
jekyll_picture_tag-2.0.4	docs/users/presets/cropping.md
jekyll_picture_tag-2.0.3	docs/users/presets/cropping.md
jekyll_picture_tag-2.0.2	docs/users/presets/cropping.md
jekyll_picture_tag-2.0.1	docs/users/presets/cropping.md
jekyll_picture_tag-2.0.0	docs/users/presets/cropping.md