mirror of
https://github.com/ryanoasis/nerd-fonts.git
synced 2024-12-25 20:18:01 +02:00
6f569003bf
[why] After updating the template the concrete README.md's have not been updated (forgotten). [how] Just call standardize-and-complete-readmes.sh Signed-off-by: Fini Jastrow <ulf.fini.jastrow@desy.de>
68 lines
3.2 KiB
Markdown
68 lines
3.2 KiB
Markdown
# Cascadia Code
|
|
|
|
**Cascadia Code** is a fun, new monospaced font that includes programming ligatures.
|
|
|
|
For more information have a look at the upstream website: https://github.com/microsoft/cascadia-code
|
|
|
|
## Preprocessed Source Font
|
|
|
|
This source font has been preprocessed - it is not taken directly from upstream.
|
|
Cascadia Code is mainly a variable font (VF) and the static versions (that Nerd Fonts
|
|
are based on) are prepared in a different way: They have been hinted with `ttfautohint`.
|
|
That hints differ considerably from the hints in the VF. That changes the rendering for
|
|
smaller sizes (usual sizes in terminals) considerably.
|
|
|
|
To get the 'original' (i.e. VF) feel of the font we redo the hints in the static versions:
|
|
Open the font with Microsoft's VisualTrueType (VTT) and apply Light Latin Autohint.
|
|
The issue is known upstream and will probably be fixed. But until it is fixed we need
|
|
to do this manual process on all source updates.
|
|
|
|
Version: 2111.01
|
|
|
|
## Why `CaskaydiaCove` and not `Cascadia Code`?
|
|
|
|
What's in a name? The reason for the name change is to comply with the SIL Open Font License (OFL), in particular the [Reserved Font Name mechanism][SIL-RFN]
|
|
|
|
Some fonts have parts of their name "reserved" per the [Reserved Font Name mechanism][SIL-RFN]:
|
|
> No Modified Version of the Font Software may use the Reserved Font
|
|
> Name(s) unless explicit written permission is granted by the corresponding
|
|
> Copyright Holder. This restriction only applies to the primary font name as
|
|
> presented to the users.
|
|
|
|
- The main goals seem to be to: `Avoid collisions`, `Protect authors`, `Minimize support`, and `Encourage derivatives`
|
|
|
|
See the [Reserved Font Name section][SIL-RFN] for additional information
|
|
|
|
## Which font?
|
|
|
|
### TL;DR
|
|
|
|
* Pick your font family:
|
|
* If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with `Nerd Font Mono` (or `NFM`).
|
|
* If you want to have bigger icons (usually around 1.5 normal letters wide) pick a font without `Mono` i.e. `Nerd Font` (or `NF`). Most terminals support this, but ymmv.
|
|
* If you work in a proportional context (GUI elements or edit a presentation etc) pick a font with `Nerd Font Propo` (or `NFP`).
|
|
|
|
### Ligatures
|
|
|
|
Ligatures are generally preserved in the patched fonts.
|
|
Nerd Fonts `v2.0.0` had no ligatures in the `Nerd Font Mono` fonts, this has been dropped with `v2.1.0`.
|
|
If you have a ligature-aware terminal and don't want ligatures you can (usually) disable them in the terminal settings.
|
|
|
|
### Explanation
|
|
|
|
Once you narrow down your font choice of family (`Droid Sans`, `Inconsolata`, etc) and style (`bold`, `italic`, etc) you have 2 main choices:
|
|
|
|
#### `Option 1: Download already patched font`
|
|
|
|
* For a stable version download a font package from the [release page](https://github.com/ryanoasis/nerd-fonts/releases)
|
|
* Or download the development version from the folders here
|
|
|
|
#### `Option 2: Patch your own font`
|
|
|
|
* Patch your own variations with the various options provided by the font patcher (i.e. not include all symbols for smaller font size)
|
|
|
|
For more information see: [The FAQ](https://github.com/ryanoasis/nerd-fonts/wiki/FAQ-and-Troubleshooting#which-font)
|
|
|
|
[SIL-RFN]:http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web_fonts_and_RFNs#14cbfd4a
|
|
|