From 0637114f065c325f145f815ce283df46556db5e8 Mon Sep 17 00:00:00 2001
From: Ralf Becker <rb@egroupware.org>
Date: Mon, 11 Nov 2024 13:50:27 +0100
Subject: [PATCH] How to add further fonts to Collabora

---
 Collabora-Integration.md | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/Collabora-Integration.md b/Collabora-Integration.md
index c41fb79..0b44634 100644
--- a/Collabora-Integration.md
+++ b/Collabora-Integration.md
@@ -81,4 +81,38 @@ extra_hosts:
 - "sub.domain.tld:172.17.0.1"
 ```
 
-Collabora Docker container needs to be restarted.
\ No newline at end of file
+Collabora Docker container needs to be restarted.
+
+## Adding further fonts
+
+1. create a directory on the EGroupware host `/var/www/html/fonts`
+2. create sub-directories for each font-family and copy the font / the *.ttf files there e.g. `my-font`
+3. create a JSON file `/var/www/html/fonts/fonts.json` like
+```
+{
+    "kind": "fontconfiguration",
+    "server": "example.egroupware.org", <-- replace with your (fully qualified) hostname
+    "fonts": [
+        {"uri":"https://collabora.egroupware.org/fonts/source-sans/TTF/SourceSans3-Black.ttf"},
+        {"uri":"https://collabora.egroupware.org/fonts/source-sans/TTF/SourceSans3-BlackIt.ttf"},
+        {"uri":"https://collabora.egroupware.org/fonts/source-sans/TTF/SourceSans3-Bold.ttf"},
+        {"uri":"https://collabora.egroupware.org/fonts/source-sans/TTF/SourceSans3-BoldIt.ttf"},
+        --> more font-files listed here
+        {"uri":"https://collabora.egroupware.org/fonts/source-code-pro/TTF/SourceCodePro-SemiboldIt.ttf"}
+    ]
+}
+```
+4. check the JSON syntax, e.g. with `jq`: `jq /var/www/html/fonts/fonts.json`
+5. edit your `/var/lib/egroupware/default/loolwsd/coolwsd.xml` and add the following e.g. before the closing `</config>`:
+```
+    <remote_font_config>
+        <url desc="URL of optional JSON file that lists fonts to be included in Online" type="string" default="">https://example.egroupware.org/fonts/fonts.json</url>
+    </remote_font_config>
+
+</config>
+```
+6. Collabora container should automatically restart and the new font(s) should be available
+
+> for more information see the [Collabora Online SDK](https://sdk.collaboraonline.com/docs/installation/Configuration.html#enable-download-and-availability-of-more-fonts-by-pointing-to-a-font-configuration-file)
+
+