Skip to content

Commit 702a256

Browse files
committed
Update readme for v1.101
1 parent 52cc750 commit 702a256

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

README.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,21 +35,23 @@ You can read more about how it works on the [Monaspace website](http://monaspace
3535
## Coding Ligatures
3636

3737
> [!WARNING]
38-
> Ligature handling has changed significantly in Monaspace v1.1. If you're upgrading from Monaspace v1.0, see the [release notes for guidance on how to alter your editor settings](https://github.com/githubnext/monaspace/releases/tag/v1.100).
38+
> Ligature handling has changed significantly in Monaspace v1.1 and v1.101. If you're upgrading, see the [release notes for guidance on how to alter your editor settings](https://github.com/githubnext/monaspace/releases/tag/v1.100).
3939
4040
The `liga` font feature enables customized spacing of repeating characters, like `///` or `||`. It is designed to avoid activating inside longer sequences like `////`.
4141

4242
There are eight groups of coding ligatures, separated into stylistic sets. You may be able to enable or disable individual sets selectively:
4343

4444
* `ss01`: ligatures related to the equals glyph like `!=` and `===`.
45-
* `ss02`: ligatures related to the greater than or less than operators.
46-
* `ss03`: ligatures related to arrows like `->` and `=>`.
45+
* `ss02`: ligatures for greater/less or equal (`<=`, `>=`).
46+
* `ss03`: ligatures related to the greater than/less than symbols like `>>` and `<=`.
4747
* `ss04`: ligatures related to markup, like `</` and `/>`.
4848
* `ss05`: ligatures related to the F# programming language, like `|>`.
4949
* `ss06`: ligatures related to repeated uses of `#`, `+`, and `&`.
5050
* `ss07`: ligatures related to colons like `::` or `=:=`.
5151
* `ss08`: ligatures related to combinations of periods with other glyphs like `..=` or `.-`.
52+
* `ss09`: ligatures related to combinations of the greater/less than and equals signs, like `<=>`,`>>`, and `=<<`.
5253

54+
👉 You can see an interactive display of all the ligatures [on the Monaspace website](http://localhost:3000/#code-ligatures)
5355

5456
## Character Variants
5557

@@ -62,14 +64,24 @@ Specific characters have variants that you can optionally enable:
6264

6365
## Desktop Installation
6466

67+
### Upgrading
68+
69+
Font caching on operating systems is an inscrutable mess dating back thirty years, and not something we can fix in Monaspace. Generally speaking, you should:
70+
71+
- First delete the old fonts…
72+
- Then install the new fonts…
73+
- Then restart applications that use the fonts…
74+
- … and maybe restart your entire computer.
75+
76+
Restarting is usually the only way to be 100% sure that the underlying machinery in the operating system picks up the new fonts.
77+
6578
### MacOS
6679
You can manually drag the fonts from the `fonts/otf` or `fonts/variable` directory into Font Book.
6780

6881
There is also a script that automates the deletion of all Monaspace fonts from `~/Library/Fonts` and then copies over the latest versions. Invoke it from the root of the repo like:
6982

7083
```bash
71-
$ cd util
72-
$ bash ./install_macos.sh
84+
$ bash util/install_macos.sh
7385
```
7486
You can also use [homebrew](https://brew.sh/) as an alternative:
7587

@@ -87,8 +99,7 @@ You can manually drag the fonts from the `fonts/otf` and `fonts/variable` direct
8799
There is also a script which automates the deletion of all Monaspace fonts from `~/.local/share/fonts` and then copies over the latest versions. Invoke it from the root of the repo like:
88100

89101
```bash
90-
$ cd util
91-
$ bash ./install_linux.sh
102+
$ bash util/install_linux.sh
92103
```
93104

94105
### Webfonts
@@ -125,7 +136,7 @@ You must use the `editor.fontLigatures` setting to enable the various features (
125136

126137
Putting it all together, a setting string which enables everything but the character variants would look like this:
127138
```json
128-
"editor.fontLigatures": "'calt', 'liga', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05', 'ss06', 'ss07', 'ss08'",
139+
"editor.fontLigatures": "'calt', 'liga', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05', 'ss06', 'ss07', 'ss08', 'ss09'",
129140
```
130141

131142
## Contribution

0 commit comments

Comments
 (0)