tall, condensed bitmap font for geeks
oppi.li
1# Installation
2
3 - [Enable bitmap fonts](#enable-bitmap-fonts)
4 - [Install from release](#install-from-release)
5 - [Build from source](#build-from-source)
6 - [Verification](#verification)
7 - [Troubleshooting](#troubleshooting)
8
9## Enable bitmap fonts
10
11If you are an Debian/Ubuntu based system, chances are bitmap
12fonts are disabled, go ahead and enable them:
13
14```
15sudo mv /etc/fonts/conf.d/10-* /etc/fonts/conf.avail/
16sudo mv /etc/fonts/conf.d/70-no-bitmaps.conf /etc/fonts/conf.avail/
17```
18
19If you would like to disable them for some reason, simply
20move the files back back from `/etc/fonts/conf.avail` to
21`/etc/fonts/conf.d`.
22
23## Install from release
24
25 1. Grab the latest release from the
26[releases](https://github.com/NerdyPepper/scientifica/releases)
27page.
28
29 2. Extract the release package:
30```shell
31tar xf scientifica-v1.2.tar.gz
32```
33
343. You may install either the `ttf`s or the `otb`s or the
35`bdf`s
36```shell
37# ttfs are recommended
38cp ttf/* ~/.local/share/fonts/
39
40# but you may install the otbs if you want to
41cp otb/* ~/.local/share/fonts
42
43# bdfs are not recommended
44cp bdf/* ~/.local/share/fonts
45```
46
47## Build from source
48
49Requirements:
50
51 - java
52 - [BitsNPicas](https://github.com/kreativekorp/bitsnpicas)
53 - [fontforge](https://fontforge.org)
54 - python3
55
56On Debian based distros, you can install all requirements
57via:
58```
59sudo apt install openjdk-8-jdk openjdk-8-jre python3 fontforge
60curl -o BitsNPicas.jar "https://github.com/kreativekorp/bitsnpicas/blob/master/downloads/BitsNPicas.jar"
61```
62
631. Set an environment variable `BNP` to the path of
64 `BitsNPicas.jar`, defaults to the current directory if
65 unset
66```shell
67# for example:
68user@host$ BNP="/home/nerdypepper/BitsNPicas.jar" ./build.sh
69```
70
712. If everything went well, you will find the generated font
72 files under the `build` folder.
733. Continue with step 3 of "Install from release"
74
75## Verification
76
77Check if your installation procedure was a success:
78
79 1. Run `fc-list | grep scientifica`
80 2. If the output is **not** null, congrats!
81 3. Proceed to [Troubleshooting](#troubleshooting) if the output is empty
82
83## Troubleshooting
84
85 If your application does not recognize the font, you can
86try a couple of things:
87
88 - use `ttf` variant instead of the `otb` or `bdf`
89 variants
90 - run `fc-cache --really-force -v` and verify again
91 - open an issue, I'd love to help you out!