How to add further fonts to Collabora

Ralf Becker 2024-11-11 13:50:27 +01:00
parent 9a1e109ae2
commit 0637114f06

@ -81,4 +81,38 @@ extra_hosts:
- "sub.domain.tld:172.17.0.1"
```
Collabora Docker container needs to be restarted.
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)