Add hint about font rendering problems to the documentation

ngandrass · Dec 10, 2024 · 9c80c96 · 9c80c96
1 parent 0132d0b
commit 9c80c96
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,10 @@
 # Changelog
 
+## Version X.X.X (YYYYMMDDXX)
+
+- Add hint about font rendering problems to the documentation
+
+
 ## Version 2.2.0 (2024102900)
 
 - Add student ID number to quiz attempt header

diff --git a/docs/configuration/initialconfig/pitfalls.md b/docs/configuration/initialconfig/pitfalls.md
@@ -77,6 +77,19 @@ back to your Moodle, you should check the following:
    `MaxScanSize`, and `StreamMaxLength` (when using a TCP socket) inside
    `clamd.conf`.
 
+
+## Text is not rendered correctly
+
+If the text in the generated PDF files is not rendered correctly, e.g., when
+only rectangles are displayed instead of characters, please make sure that an
+extended set of base fonts is available on your server.
+
+If you are running Ubuntu or Debian, you can ensure this by installing the
+`fonts-noto` package via your package manager.
+
+If you are using the official Docker image, please open a bug report instead.
+
+
 ## Checking the plugin config
 
 If you are unsure whether there is a problem with your plugin configuration, you