From 6fb592248bce43ac658e9ecee1b7c97a34c52e05 Mon Sep 17 00:00:00 2001
From: Mario <wrong7@users.noreply.github.com>
Date: Wed, 3 Apr 2024 15:08:14 +0200
Subject: [PATCH 1/2] docs: include Windows guide for custom fonts

This commit also includes information about the importance of creating a single texture and generating the charset file.
---
 docs/tutorials/custom-fonts.md | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/docs/tutorials/custom-fonts.md b/docs/tutorials/custom-fonts.md
index 0580223a..004ea12e 100644
--- a/docs/tutorials/custom-fonts.md
+++ b/docs/tutorials/custom-fonts.md
@@ -10,20 +10,38 @@ The `Text` component enables rendering text using multi-channel signed distance
 
 This example shows how to compile the `Roboto` font family with the weight `medium`.
 
-The first step is to download a `.ttf` file for the font family with the correct weights. After downloading the font to `roboto.ttf`, the following command can be used to remove overlaps.
+The first step is to download a `.ttf` file for the font family with the correct weights. After downloading the font to `roboto.ttf`, the overlaps need to be removed.
 
 > This is necessary because msdf-bmfont has a problem with overlapping paths, creating weird artificats.
 
+##### Linux
 ```bash
 fontforge -lang=ff -c 'Open($1); SelectAll(); RemoveOverlap(); Generate($2)' roboto.ttf fixed-roboto.ttf 
 ```
 
-Next, we use `msdf-bmfont` to convert the `.ttf` file to a texture and a `.json` file.
+##### Windows
+1. Install [FontForge](https://fontforge.org/en-US/downloads/windows-dl/).
+2. Open the `.ttf` font.
+3. Select all the characters using `CTRL+A` or navigating to `Edit > Select > Select All`.
+4. Remove overlap using `CTRL+Shift+O` or navigating to `Element > Overlap > Remove Overlap`.
+5. Generate fonts using `CTRL+Shift+G` or navigating to `File > Generate font(s)` in Truetype (`.ttf`) font.
+> Tip: give a new name to the new generated font.
+
+#### Generating the msdf font
+Next, we use `msdf-bmfont` to convert the `.ttf` file to a texture and a `.json` file. For that we need the *FontForge* generated font and a charset file containing all the characters we want to include in our msdf-font.
+
+```
+charset.txt
+ !\"#$%&'()*+,-./0123456789:;<=>?@ÄÖÜABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`äöüabcdefghijklmnopqrstuvwxyz{|}~ߧ
+```
 
 ```bash
-npx msdf-bmfont -f json roboto.ttf -i charset.txt -m 256,512 -o public/roboto -s 48
+npx msdf-bmfont -f json fixed-roboto.ttf -i charset.txt -m 256,512 -o public/roboto -s 48
 ```
 
+> **IMPORTANT:** Only a single texture file is supported by uikit, so make sure the generated texture is a single file. Otherwise adjust the texture by increasing the resolution or by decreasing the font size.
+
+#### Implementing the generated font
 Lastly, we add the font family via the `FontFamilyProvider`. It's necessary to host the `.json` file and the texture on the same URL and provide the URL to the `.json` file to the  `FontFamilyProvider`.
 
 Repeat the previous process for other weights, such as bold, to support different weights.

From ff6732b7b2accc7b8c6161725ef434a7b8413aa8 Mon Sep 17 00:00:00 2001
From: Bela Bohlender <85560643+bbohlender@users.noreply.github.com>
Date: Wed, 3 Apr 2024 16:45:27 +0200
Subject: [PATCH 2/2] fix: custom font docs adding language type to charset
 example

---
 docs/tutorials/custom-fonts.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/tutorials/custom-fonts.md b/docs/tutorials/custom-fonts.md
index 004ea12e..12219883 100644
--- a/docs/tutorials/custom-fonts.md
+++ b/docs/tutorials/custom-fonts.md
@@ -30,15 +30,15 @@ fontforge -lang=ff -c 'Open($1); SelectAll(); RemoveOverlap(); Generate($2)' rob
 #### Generating the msdf font
 Next, we use `msdf-bmfont` to convert the `.ttf` file to a texture and a `.json` file. For that we need the *FontForge* generated font and a charset file containing all the characters we want to include in our msdf-font.
 
-```
-charset.txt
- !\"#$%&'()*+,-./0123456789:;<=>?@ÄÖÜABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`äöüabcdefghijklmnopqrstuvwxyz{|}~ߧ
-```
-
 ```bash
 npx msdf-bmfont -f json fixed-roboto.ttf -i charset.txt -m 256,512 -o public/roboto -s 48
 ```
 
+example charset.txt:
+```txt
+ !\"#$%&'()*+,-./0123456789:;<=>?@ÄÖÜABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`äöüabcdefghijklmnopqrstuvwxyz{|}~ߧ
+```
+
 > **IMPORTANT:** Only a single texture file is supported by uikit, so make sure the generated texture is a single file. Otherwise adjust the texture by increasing the resolution or by decreasing the font size.
 
 #### Implementing the generated font