sidneypepo
/
iosevka_builder
1
1
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity
A simple script to build (and patch) Iosevka
1 Commit 1 Branch 1 Tag 46 KiB
Shell 100%
Go to file
Sidney PEPO (aka sysb1n) f41cec8718
Initial commit 		2024-05-19 01:32:09 -03:00
.gitignore Initial commit 2024-05-19 01:32:09 -03:00
COPYING Initial commit 2024-05-19 01:32:09 -03:00
README.org Initial commit 2024-05-19 01:32:09 -03:00
ib_functions.sh Initial commit 2024-05-19 01:32:09 -03:00
iosevka_builder.sh Initial commit 2024-05-19 01:32:09 -03:00

README.org

README

Iosevka Builder

A simple script to build (and patch) Iosevka.

Dependencies

To run this program, you need to have installed:

  • Git
  • NodeJS and NPM
  • sed
  • ttfautohint
  • Wget
  • unzip
  • FontForge
  • Python (3, obviously) and its argparse lib

Usage

Before we start, Iosevka Builder need to have an Iosevka config file. In order to get your own, access https://typeof.net/Iosevka/customizer and customize your font features (steps 1 to 3), then save the generated TOML (step 4) to a file (you can name and store it the way you want, but it's recommended to name it as private-build-plans.toml and place it at root of this project to be auto detected by the script). A private-build-plans.toml example:

[buildPlans.Iojetka]
family = "Iojetka"
spacing = "normal"
serifs = "sans"
noCvSs = true
exportGlyphNames = false

  [buildPlans.Iojetka.variants]
  inherits = "ss14"

  [buildPlans.Iojetka.ligations]
  inherits = "dlig"

You can find a build made with the above config at Releases page, with its respective checksums and signatures.

Now, with a custom Iosevka config, Iosevka Builder can be run. The command most of users will use is

./iosevka_builder.sh -f -q

or simply

./iosevka_builder.sh -fq

that'll quietly (-q) perform a full build (-f) (i.e., build Iosevka and then patch it with Nerd Fonts). If you've saved your custom config file with a non-default name and/or location, you should also use -c FILE to specify your config FILE path.

Once it's done, the built and patched fonts will be in their own subdirectories of font directory (the patched one has NF as directory suffix).

Note: a full build (build + patch) may take several hours depending of your hardware, so be patient!

The full list of options (and their uses) can be found by running

./iosevka_builder.sh -h

Install built font

Installation can be made in two ways: local and system-wide

  • Local installation:

    mkdir -p ~/.local/share/fonts

cp font/* ~/.local/share/fonts/

  • System-wide installation:

    mkdir -p /usr/share/fonts

cp font/* /usr/share/fonts/

Note: system-wide installation requires superuser privileges.

Credits

This project was only possible thanks to

Go check it now! ❤️