From bda7cb4699c4a0b43974b0ba32c3877b5a6e1492 Mon Sep 17 00:00:00 2001
From: Mark Joshwel <mark@joshwel.co>
Date: Thu, 4 Jul 2024 18:11:47 +0800
Subject: [PATCH] add an instruction to clone not download + reformat

---
 README.md | 57 ++++++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 40 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index b1bb4bf..9216b38 100644
--- a/README.md
+++ b/README.md
@@ -2,43 +2,66 @@
 
 a collection of fonts that are licenced under the Open Font Licence
 
+meaning you can use them for personal _and commercial use_
+(i'd recommend still crediting the authors though)
+
 **except for**
 
-- `sources/JohnnyGLTFont.zip` by u/JohnnyDZ0707 [(link)](https://old.reddit.com/r/GirlsLastTour/comments/e5wprz/i_made_a_font_link_in_comments_english_numbers/)
+- `sources/JohnnyGLTFont.zip` by
+  u/JohnnyDZ0707 [(link)](https://old.reddit.com/r/GirlsLastTour/comments/e5wprz/i_made_a_font_link_in_comments_english_numbers/)
 
 ## instructions
 
 steps to extract everything from the zip files:
 
 > [!NOTE]  
-> tips for windows users:
->
-> - when extracting, you can select all the zip files via clicking on `Type` to sort by type, then selecting all the zip files
+> **a tip for Windows users:** when extracting, you can select all the zip files via
+> clicking on `Type` to sort by type, then selecting all the zip files
 
+1. get the fonts
 
-1. extract every `sources/*.zip` to `sources/ext/*`
+   > [!WARNING]  
+   > do NOT download a zip archive of the repository, as it will not contain the fonts
+   > due to a bug with [forgejo/gitea and git lfs](https://github.com/go-gitea/gitea/issues/4773)
 
-    for windows: select everything in sources, right click, `Extract files...` (7-zip)
+   run the following command to clone the repository:
 
-    modify the path to add a `ext/` after `sources/`
+   ```text
+   git clone https://forge.joshwel.co/mark/fonts
+   ```
 
-    ![instructions](extract-7zip-example.png)
+   for Windows users or non-terminal users:
+    - right-click a directory where you want to save the fonts
+    - right-click, and click on `Open in Terminal`
+    - then, type out '`git clone https://forge.joshwel.co/mark/fonts`' (without the single quotes btw) within the black
+      box
+    - press enter to run it
 
-2. run `python extract.py`
+   if you don't have git installed, you can download it from [here](https://git-scm.com/downloads)
+
+2. extract every `sources/*.zip` to `sources/ext/*`
+
+   for windows: select everything in sources, right-click, `Extract files...` (7-zip)
+
+   modify the path to add a `ext/` after `sources/`
+
+   ![instructions](extract-7zip-example.png)
+
+3. run `python extract.py`
 
    this will extract all the fonts to `files/`
-   
-   for windows users or non-power users:
-   - right-click in the newly created `fonts` folder
-   - right-click, and click on `Open in Terminal`
-   - then, type out '`python extract.py`' (without the single quotes btw) within the black box
-   - press enter to run it
+
+   for Windows users or non-terminal users:
+    - right-click in the newly created `fonts` folder
+    - right-click, and click on `Open in Terminal`
+    - then, type out '`python extract.py`' (without the single quotes btw) within the black box
+    - press enter to run it
 
    ![example](extract-terminal-example.png)
 
    if you get an error, you might need to install python from [here](https://www.python.org/downloads/)
 
-3. install the fonts in `files/`
+4. install the fonts in `files/`
 
     - **for windows**  
       select all the fonts, right-click, `Install` or `Install for all users`
@@ -55,4 +78,4 @@ steps to extract everything from the zip files:
     - **for linux**  
       copy the fonts to `~/.local/share/fonts/`, `/usr/share/fonts/`, or `/usr/local/share/fonts/`
 
-    for *nix systems, you can also use a font manager if you prefer
+   for *nix systems, you can also use a font manager if you prefer