mirror/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2025-08-17 21:01:26 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
release-0.137.1
hugo/docs/content/en/methods/resource/Fit.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 Permalink Blame History

title, description, categories, keywords, action, toc
title description categories keywords action toc
Fit Applicable to images, returns an image resource downscaled to fit the given dimensions while maintaining aspect ratio.
related returnType signatures
methods/resource/Crop
methods/resource/Fill
methods/resource/Resize
methods/resource/Process
functions/images/Process
images.ImageResource
RESOURCE.Fit SPEC
true

Downscale an image to fit the given dimensions while maintaining aspect ratio. You must provide both width and height.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Fit "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 .Fit "300x175 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="fit 300x175 webp q85 lanczos" example=true

}}