Skip to content

Commit ca42d97

Browse files
FabianBeineridan
authored andcommitted
Update README.md
Corrected some spelling mistakes, added Windows instructions, and tried to simplify readability.
1 parent 88ee59d commit ca42d97

1 file changed

Lines changed: 23 additions & 20 deletions

File tree

README.md

Lines changed: 23 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Monaspace
22

3-
The Monaspace type system: a monospaced type superfamily with some modern tricks up its sleeves. It is comprised of five variable axis typefaces. Each one has a distinct voice, but they are all metrics-compatible with one another, allowing you to mix and match them for a more expressive typographical palette.
3+
The Monaspace type system is a monospaced type superfamily with some modern tricks up its sleeve. It consists of five variable axis typefaces. Each one has a distinct voice, but they are all metrics-compatible with one another, allowing you to mix and match them for a more expressive typographical palette.
44

55
Letters on a grid is how we see our code. Why not make those letters better?
66

@@ -13,20 +13,20 @@ Letters on a grid is how we see our code. Why not make those letters better?
1313

1414
## Overview
1515

16-
Monaspace is made available as both a variable-axis font and as static builds. You can install them both side-by-side; their family names are distinct. For example:
16+
Monaspace is available as a variable-axis font and a static build. You can install them both side-by-side; their family names are distinct. For example:
1717

1818
- `Monaspace _____`: the static family
1919
- `Monaspace _____ Var` or `VF`: the variable family
2020

21-
The variable fonts have one file per family (Neon, Argon, etc). Modern and convenient!
21+
The variable fonts have one file per family (Neon, Argon, etc.). Modern and convenient!
2222

23-
The static fonts have one file per cut per family. The variable axes have named stops for each of the axes, like `light` or `bold` for weight, `italic` for italics, and `semiwide` and `wide` for width. The combinatoric explosion of all these properties means that the full installation of static fonts involves hundreds of font files. But for situations which don't yet support variable fonts, the static builds give you a wide variety of stops throughout the range of each axis.
23+
The static fonts have one file per cut, per family. The variable axes have named stops for each axe, like `light` or `bold` for weight, `italic` for italics, and `semiwide` or `wide` for width. The combinatorial explosion of all these properties means the complete installation of static fonts involves hundreds of font files. But for situations that don't yet support variable fonts, the static builds give you a wide variety of stops throughout the range of each axis.
2424

2525
## Coding Ligatures
2626

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

29-
* `ss01`: ligatures related to the equals glyph like `!=` and `===`.
29+
* `ss01`: ligatures related to the equals' glyph like `!=` and `===`.
3030
* `ss02`: ligatures related to the greater than or less than operators.
3131
* `ss03`: ligatures related to arrows like `->` and `=>`.
3232
* `ss04`: ligatures related to markup, like `</` and `/>`.
@@ -35,28 +35,31 @@ There are eight groups of coding ligatures, separated into stylistic sets. You m
3535
* `ss07`: ligatures related to the asterisk like `***`.
3636
* `ss08`: ligatures related to combinations like `.=` or `.-`.
3737

38-
You must enable discrectionary ligatures first, often using the `dlig` setting. See below for editor-specific instructions.
38+
You must enable discretionary ligatures first, often using the `dlig` setting. See below for editor-specific instructions.
3939

4040
![A visual glossary of code ligatures available in the Monaspace type system](https://github.com/githubnext/monaspace/assets/22723/49b4f802-265d-414c-94c0-ec712e3c0ecc)
4141

4242

4343
## Desktop Installation
4444

4545
### MacOS
46-
You can manually drag the fonts from the `fonts/otf` and `fonts/variable` directory into Font Book.
46+
You can manually drag the fonts from the `fonts/otf` or `fonts/variable` directory into Font Book.
4747

48-
There is also a script which 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:
48+
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:
4949

5050
```bash
5151
$ cd util
5252
$ bash ./install_macos.sh
5353
```
5454

55+
### Windows
56+
You can manually drag the fonts from the `fonts/otf` or `fonts/variable` directory into `C:\Windows\Fonts`. Alternatively, right-click the fonts you want and click Install.
57+
5558
### Webfonts
5659

57-
All files with a `.woff` or `.woff2` suffix are intended for use on the web. You do not install them with your operating system, but rather add them to your web development project.
60+
All files with a `.woff` or `.woff2` suffix are intended for use on the web. You do not install them with your operating system but add them to your web development project.
5861

59-
As with the desktop fonts, they are made available both as variable and static fonts.
62+
As with the desktop fonts, they are available in variable and static versions.
6063

6164
## Editors
6265

@@ -71,7 +74,7 @@ Set the font family:
7174
> [!NOTE]
7275
> Variable fonts are not yet well-supported in VS Code, and it is not yet possible to mix multiple fonts. Stay tuned, we're talking with the VS Code team about it!
7376
74-
Texture healing and coding ligatures are controlled by the same setting. You can enable either, or both.
77+
The same setting controls texture healing and coding ligatures. You can enable either or both.
7578

7679
If you only want texture healing and basic coding ligatures, add the following line to your `settings.json`:
7780

@@ -80,29 +83,29 @@ If you only want texture healing and basic coding ligatures, add the following l
8083
```
8184

8285
> [!NOTE]
83-
> This setting is not available from the graphical settings editor, you must create it manually.
86+
> This setting is unavailable from the graphical settings editor; you must create it manually.
8487
85-
If you want more coding ligatures, you must customize that setting to specify all of the sets you want enabled:
88+
If you want more coding ligatures, you must customize that setting to specify all the sets you wish to enable:
8689

8790
```json
8891
"editor.fontLigatures": "'calt', 'liga', 'dlig', 'ss01', 'ss02', ... (more stylistic sets) ...",
8992
```
9093
> [!NOTE]
91-
> You must start the setting with `'calt', 'liga', 'dlig'`! The stylistic sets will not have any effect without enabling contextual alternates, ligatures, and discretionary ligatures.
94+
> You must start the setting with `'calt', 'liga', 'dlig'`! The stylistic sets will only have an effect by enabling contextual alternates, ligatures, and discretionary ligatures.
9295
93-
If you want coding ligatures but do _not_ want texture healing, you can elide the `calt` setting:
96+
If you want coding ligatures but do _not_ want texture healing, you can omit the `calt` setting:
9497

9598
```json
9699
"editor.fontLigatures": "'liga', 'dlig', 'ss01', 'ss02', ... (more stylistic sets) ...",
97100
```
98101

99102
## Contribution
100103

101-
There's no formal contribution guide yet! If you're interested in contributing to the typefaces, you should read the [Texture Healing](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md) guide, as it explains how to produce the neccessary alternate glyphs.
104+
There's no formal contribution guide yet! If you're interested in contributing to the typefaces, you should read the [Texture Healing](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md) guide, as it explains how to produce the necessary alternate glyphs.
102105

103106
### Renamer utility
104107

105-
This is a convenience utility which renames moves the built fonts into the respective directories. You will need [Deno](https://deno.land) installed, and invoke it thus:
108+
This convenience utility renames and moves the built fonts into their respective directories. You will need [Deno](https://deno.land) installed, and invoke it thus:
106109

107110
```bash
108111
$ ./util/renamer.ts --src="~/path/to/the/built/fonts"
@@ -114,11 +117,11 @@ SIL OFL. See [LICENSE](https://github.com/githubnext/monaspace/blob/main/LICENSE
114117

115118
## Support
116119

117-
Please file issues on this repo. Monaspace is not a supported product; do not reach out to GitHub support with questions as they do not provide support for GitHub Next explorations.
120+
Please file issues in this repo. Monaspace is not a supported product; do not contact GitHub support with questions, as they do not support GitHub Next explorations.
118121

119122
## Contributors
120123

121-
Monaspace was made with the goal of improving all code, for all developers. [GitHub Next](https://githubnext.com) set out on this journey in 2022, and we were fortunate to find a type foundry that shares our passion for improving software in [Lettermatic](https://lettermatic.com/). The result is a marriage of form and function that opens the door to new developer experiences, and that would not have been possible without the domain expertise and skill of the lettermatic team, and the time they invested to work with GitHub Next on figuring out how typography ought to work for code.
124+
Monaspace was made to improve all code for all developers. [GitHub Next](https://githubnext.com) set out on this journey in 2022, and we were fortunate to find a type foundry that shares our passion for improving software in [Lettermatic](https://lettermatic.com/). The result is a marriage of form and function that opens the door to new developer experiences, and that would not have been possible without the domain expertise and skill of the Lettermatic team and the time they invested in working with GitHub Next on figuring out how typography ought to work for code.
122125

123126

124127
#### Lettermatic

0 commit comments

Comments
 (0)