nerd-fonts/patched-fonts/JetBrainsMono/Ligatures/readme.md

JetBrains Mono

A typeface made for developers.
More about font features & design can be found on its page.

By default, JetBrains Mono includes ligatures. The version without ligatures is called JetBrains Mono NL and can be found here. This version is also stripped of all OpenType features, since they don't have any effect when your IDE doesn't support OpenType.

If your IDE supports OpenType we recommend installing the default version of the font. If you prefer not using ligatures you can turn them off manually in the settings.

Installation

In JetBrains IDEs

The most recent version of JetBrains Mono ships with your JetBrains IDE starting with v2019.3.

Select JetBrains Mono in the IDE settings: go to Preferences/Settings → Editor → Font, and then select JetBrains Mono from the Font dropdown.

Another IDE or an older version of a JetBrains IDE

Through brew (MacOS only)

1. Tap the font cask to make the Jetbrains Mono font available :

   brew tap homebrew/cask-fonts
   

2. Install it using the font-jetbrains-mono cask:

   brew install --cask font-jetbrains-mono
   

Through Chocolatey (Windows only)

1. Install Chocolatey if you haven't done already. See this page for instructions on how to do that.

2. In an elevated cmd console (Run as administrator...) :

   choco install jetbrainsmono
   

Or manually

On Mac/Windows:

1. Download font.
2. Unzip the archive and install the font:
   • Mac. Select all font files in the folder and double-click them. Click the "Install Font" button.
   • Windows. Select all font files in the folder, right-click any of them, then pick "Install" from the menu.

On Linux:

Open a terminal and run the following:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/JetBrains/JetBrainsMono/master/install_manual.sh)"

Once JetBrains Mono is installed in your OS, you are ready to configure the editor.

JetBrains IDEs

• Restart your IDE.
• Go to Preferences/Settings → Editor → Font, and pick JetBrains Mono from the Font dropdown.

Visual Studio Code

• Go to the settings editor, from the File menu choose Preferences, Settings or use keyboard shortcut Ctrl+, (Cmd+, on Mac).
• In the "Font Family" input box type JetBrains Mono, replacing any content.
• To enable ligatures turn on the checkbox in "Font ligatures".

Manually editing settings.json

Visual Studio Code allows you to also edit the underlying settings.json config file. First open the settings editor as described above, then click the "{}" icon, at the top right, to open the "settings.json" file.

Then paste the following lines and save the file.

"editor.fontFamily": "JetBrains Mono",
"editor.fontLigatures": true,

ChromeOS Terminal

In the terminal:

1. Use the keyboard shortcut CTRL + SHIFT + P to open up settings.
2. Scroll down to "Custom CSS (Inline Text)".
3. Copy & paste the following:

@font-face{
    font-family: 'JetBrains Mono';
    src: url('https://raw.githubusercontent.com/JetBrains/JetBrainsMono/master/fonts/webfonts/JetBrainsMono-Regular.woff2') format('woff2'),
         url('https://raw.githubusercontent.com/JetBrains/JetBrainsMono/master/fonts/ttf/JetBrainsMono-Regular.ttf') format('truetype');
    font-weight: normal;
    font-style: normal;
}

* {
    -webkit-font-feature-settings: "liga" on, "calt" on;
    -webkit-font-smoothing: antialiased;
    text-rendering: optimizeLegibility;
    font-family: 'JetBrains Mono';
}

Source files

Can be found in the "Source" folder. To open them you will need Glyphs app.

License

JetBrains Mono typeface is available under the OFL-1.1 License and can be used free of charge, for both commercial and non-commercial purposes. You do not need to give credit to JetBrains, although we will appreciate it very much if you do.

The source code is available under Apache 2.0 License

Credits

Type designer
Philipp Nurullin

Team lead
Konstantin Bulenkov

Thanks to
Nikita Prokopov
Eugene Auduchinok
Tatiana Tulupenko
Dmitrij Batrak
IntelliJ Platform UX Team
Web Team

Which font?

TL;DR

• Pick your font family and then select from the 'complete' directory.
  • If you are on Windows pick a font with the 'Windows Compatible' suffix.
    • This includes specific tweaks to ensure the font works on Windows, in particular monospace identification and font name length limitations
  • If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with the 'Mono' suffix.
    • This denotes that the Nerd Font glyphs will be monospaced not necessarily that the entire font will be monospaced

Ligatures

By the Nerd Font policy, the variant with the 'Mono' suffix is not supposed to have any ligatures. Use the non-Mono variants to have ligatures.

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

• download an already patched font from the complete folder
  • This is most likely the one you want. It includes all of the glyphs from all of the glyph sets. Only caution here is that some fonts have glyphs in the same code point so to include everything some had to be moved to alternate code points.

Option 2: Patch your own font

• patch your own variations with the various options provided by the font patcher (see each font's readme for full list of combinations available)
  • This is the option you want if the font you use is not already included or you want maximum control of what's included
  • This contains a list of all permutations of the various glyphs. E.g. You want the font with only Octicons or you want the font with just Font Awesome and Devicons. The goal is to provide every combination possible in this folder.

For more information see: The FAQ

Variations (Combinations)

The combinations and total number of combinations are provided here for reference if you want to create your own variation of a patched Nerd Font.

Why aren't all variations included ?

Combinations are no longer included by default because of the large inflation in size it caused the Repository and the amount of time it takes to rebuild all of the combinations. This issue would exponentially get worse as the numbers of Fonts and Glyph Sets provided increase.