Update installation guide

This commit is contained in:
be5invis 2024-02-25 07:45:46 -08:00
parent c9843ff8da
commit 6163856495

View file

@ -8,8 +8,25 @@
## Installation
### Installing from GitHub Releases
1. Download your font package from [releases](https://github.com/be5invis/Iosevka/releases).
* For Linux users you could use the following command to download all the packages in the latest release:
```bash
curl -s 'https://api.github.com/repos/be5invis/Iosevka/releases/latest' | jq -r ".assets[] | .browser_download_url" | grep ttf-iosevka | xargs -n 1 curl -L -O --fail --silent --show-error
```
2. Quit all your editors / programs.
3. Unarchive the font package and you will see the font files.
4. Take actions depending on your OS:
* **Windows**: Select the font files and drag into font [settings](ms-settings:fonts) / font control panel page.
* On Windows 10 1809 or newer, the default font installation is per-user, and it may cause compatibility issues for some applications, mostly written in Java. To cope with this, right click and select “Install for all users” instead. [Ref.](https://youtrack.jetbrains.com/issue/JRE-1166?p=IDEA-200145)
* **macOS**: [Follow instructions here](http://support.apple.com/kb/HT2509).
* **Linux** : Copy the font files to your fonts directory then run `sudo fc-cache`.
### Installing via Package Managers
*Be careful: This repository does not maintain any package manager distribution. The packages listed below might be outdated.*
* **macOS**
* Standard distribution in Homebrew:
```bash
@ -26,21 +43,6 @@
* **FreeBSD**: The font can be installed with `pkg install iosevka`.
* **OpenBSD**: Run `pkg_info -Q iosevka` to see which Iosevka packages are available. Use `pkg_add` to install the chosen package(s).
### Manual Installation
1. Download your font package from [releases](https://github.com/be5invis/Iosevka/releases).
* For Linux users you could use the following command to download all the packages in the latest release:
```bash
curl -s 'https://api.github.com/repos/be5invis/Iosevka/releases/latest' | jq -r ".assets[] | .browser_download_url" | grep ttf-iosevka | xargs -n 1 curl -L -O --fail --silent --show-error
```
2. Quit all your editors / programs.
3. Unarchive the font package and you will see the font files.
4. Take actions depending on your OS:
* **Windows**: Select the font files and drag into font [settings](ms-settings:fonts) / font control panel page.
* On Windows 10 1809 or newer, the default font installation is per-user, and it may cause compatibility issues for some applications, mostly written in Java. To cope with this, right click and select “Install for all users” instead. [Ref.](https://youtrack.jetbrains.com/issue/JRE-1166?p=IDEA-200145)
* **macOS**: [Follow instructions here](http://support.apple.com/kb/HT2509).
* **Linux** : Copy the font files to your fonts directory then run `sudo fc-cache`.
## Features
In the official package, Iosevka provides 6 monospace subfamilies (sans-serif and slab-serif, each in the 3 spacings Default, Term and Fixed) and 2 quasi-proportional subfamilies (Aile (sans-serif) and Etoile (slab-serif)). In all the monospace subfamilies, 9 weights (Thin to Heavy), 2 widths (Normal and Extended), and 3 slopes (Upright, Italic and Oblique) are included. In the quasi-proportional subfamilies, the quantity of widths is reduced to 1.