You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+19-8Lines changed: 19 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,21 +35,23 @@ You can read more about how it works on the [Monaspace website](http://monaspace
35
35
## Coding Ligatures
36
36
37
37
> [!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).
39
39
40
40
The `liga` font feature enables customized spacing of repeating characters, like `///` or `||`. It is designed to avoid activating inside longer sequences like `////`.
41
41
42
42
There are eight groups of coding ligatures, separated into stylistic sets. You may be able to enable or disable individual sets selectively:
43
43
44
44
*`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 `<=`.
47
47
*`ss04`: ligatures related to markup, like `</` and `/>`.
48
48
*`ss05`: ligatures related to the F# programming language, like `|>`.
49
49
*`ss06`: ligatures related to repeated uses of `#`, `+`, and `&`.
50
50
*`ss07`: ligatures related to colons like `::` or `=:=`.
51
51
*`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 `=<<`.
52
53
54
+
👉 You can see an interactive display of all the ligatures [on the Monaspace website](http://localhost:3000/#code-ligatures)
53
55
54
56
## Character Variants
55
57
@@ -62,14 +64,24 @@ Specific characters have variants that you can optionally enable:
62
64
63
65
## Desktop Installation
64
66
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
+
65
78
### MacOS
66
79
You can manually drag the fonts from the `fonts/otf` or `fonts/variable` directory into Font Book.
67
80
68
81
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:
69
82
70
83
```bash
71
-
$ cd util
72
-
$ bash ./install_macos.sh
84
+
$ bash util/install_macos.sh
73
85
```
74
86
You can also use [homebrew](https://brew.sh/) as an alternative:
75
87
@@ -87,8 +99,7 @@ You can manually drag the fonts from the `fonts/otf` and `fonts/variable` direct
87
99
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:
88
100
89
101
```bash
90
-
$ cd util
91
-
$ bash ./install_linux.sh
102
+
$ bash util/install_linux.sh
92
103
```
93
104
94
105
### Webfonts
@@ -125,7 +136,7 @@ You must use the `editor.fontLigatures` setting to enable the various features (
125
136
126
137
Putting it all together, a setting string which enables everything but the character variants would look like this:
0 commit comments