github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-12-18 15:16:45 -05:00
Code Issues Projects Releases Packages Wiki Activity
hugo/docs/content/en/methods/resource/Crop.md
Bjørn Erik Pedersen 5fd1e74903
Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs' 
```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925
2024-01-27 10:48:57 +01:00

1.3 KiB
Raw Blame History

title description categories keywords action toc
Crop Applicable to images, returns an image resource cropped to the given dimensions without resizing.
related returnType signatures
methods/resource/Fit
methods/resource/Fill
methods/resource/Resize
methods/resource/Process
functions/images/Process
images.ImageResource
RESOURCE.Crop SPEC
true

Crop an image to match the given dimensions without resizing. You must provide both width and height.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200" }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

{{% include "methods/resource/_common/global-page-remote-resources.md" %}}

{{% include "/methods/resource/_common/processing-spec.md" %}}

Example

{{ with resources.Get "images/original.jpg" }}
  {{ with .Crop "200x200 topright webp q85 lanczos" }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

{{< img src="images/examples/zion-national-park.jpg" alt="Zion National Park" filter="Process" filterArgs="crop 200x200 topright webp q85 lanczos" example=true

}}