diff options
Diffstat (limited to 'docs/content/en/functions/truncate.md')
| -rw-r--r-- | docs/content/en/functions/truncate.md | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/content/en/functions/truncate.md b/docs/content/en/functions/truncate.md new file mode 100644 index 000000000..8d0dd36b1 --- /dev/null +++ b/docs/content/en/functions/truncate.md @@ -0,0 +1,28 @@ +--- +title: truncate +# linktitle: truncate +description: Truncates a text to a max length without cutting words or leaving unclosed HTML tags. +date: 2017-02-01 +publishdate: 2017-02-01 +lastmod: 2017-02-01 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [strings] +signature: ["truncate SIZE INPUT", "truncate SIZE ELLIPSIS INPUT"] +workson: [] +hugoversion: 19 +relatedfuncs: [] +deprecated: false +--- + +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 [`safeHTML` template function](/functions/safehtml) before sending the value to truncate. Otherwise, the HTML tags will be escaped when passed through the `truncate` function. +{{% /note %}} |