hugo/docs/content/en/functions/strings/Truncate.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

906 B

title description categories keywords action aliases
strings.Truncate Returns the given string, truncating it to a maximum length without cutting words or leaving unclosed HTML tags.
aliases related returnType signatures
truncate
template.HTML
strings.Truncate SIZE [ELLIPSIS] INPUT
/functions/truncate

Since Go templates are HTML-aware, truncate will intelligently handle normal strings vs HTML strings:

{{ "<em>Keep my HTML</em>" | safeHTML | truncate 10 }}<em>Keep my …</em>

{{% note %}} If you have a raw string that contains HTML tags you want to remain treated as HTML, you will need to convert the string to HTML using the safeHTMLfunction before sending the value to truncate. Otherwise, the HTML tags will be escaped when passed through the truncate function.

{{% /note %}}