From 2e3573899e98bb822394268075eec31adcec46b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?=
 <bjorn.erik.pedersen@gmail.com>
Date: Tue, 7 Dec 2021 12:49:53 +0100
Subject: [PATCH] Add custom font support to images.Text

Fixes #9253
---
 content/en/functions/images/index.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/content/en/functions/images/index.md b/content/en/functions/images/index.md
index 274072dba..1cf69ee78 100644
--- a/content/en/functions/images/index.md
+++ b/content/en/functions/images/index.md
@@ -42,6 +42,8 @@ The above will overlay `$logo` in the upper left corner of `$img` (at position `
 
 ### Text
 
+{{< new-in "0.90.0" >}}
+
 Using the `Text` filter, you can add text to an image.
 
 {{% funcsig %}}
@@ -50,7 +52,7 @@ images.Text TEXT DICT)
 
 The following example will add the text `Hugo rocks!` to the image with the specified color, size and position.
 
-```
+```go-html-template
 {{ $img := resources.Get "/images/background.png"}}
 {{ $img = $img.Filter (images.Text "Hugo rocks!" (dict
     "color" "#ffffff"
@@ -61,6 +63,18 @@ The following example will add the text `Hugo rocks!` to the image with the spec
 ))}}
 ```
 
+You can load a custom font if needed. Load the font as a Hugo `Resource` and set it as an option:
+
+```go-html-template
+
+{{ $font := resources.Get "https://github.com/google/fonts/raw/main/apache/roboto/static/Roboto-Black.ttf" }}
+{{ $img := resources.Get "/images/background.png"}}
+{{ $img = $img.Filter (images.Text "Hugo rocks!" (dict
+    "font" $font
+))}}
+```
+
+
 ### Brightness
 
 {{% funcsig %}}