1
0
mirror of https://github.com/ryanoasis/nerd-fonts.git synced 2024-12-13 17:18:37 +02:00
nerd-fonts/patched-fonts/FiraCode
2019-07-09 00:38:06 -07:00
..
Bold Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
Light Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
Medium Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
Regular Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
Retina Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
font-info.md Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00
readme.md Rebuilds fonts for v2.1.0 alpha (pre-release) WIP 2019-07-09 00:38:06 -07:00

Fira Code: monospaced font with programming ligatures

Problem

Programmers use a lot of symbols, often encoded with several characters. For the human brain, sequences like ->, <= or := are single logical tokens, even if they take two or three characters on the screen. Your eye spends a non-zero amount of energy to scan, parse and join multiple characters into a single logical one. Ideally, all programming languages should be designed with full-fledged Unicode symbols for operators, but that’s not the case yet.

Solution

Download v1.206 · How to install · Troubleshooting · News & updates

Fira Code is an extension of the Fira Mono font containing a set of ligatures for common programming multi-character combinations. This is just a font rendering feature: underlying code remains ASCII-compatible. This helps to read and understand code faster. For some frequent sequences like .. or //, ligatures allow us to correct spacing.

Code examples

Ruby:

JavaScript:

PHP:

Erlang:

Elixir:

Go:

LiveScript:

Clojure:

Swift:

Terminal support

Works Doesn’t work
Butterfly Alacritty
Hyper.app cmd.exe
iTerm 2 (3.1+) Cmder
Kitty ConEmu
Konsole GNOME Terminal
mintty (2.8.3+) mate-terminal
QTerminal PuTTY
Terminal.app rxvt
Termux ZOC (Windows)
Token2Shell/MD gtkterm, guake, LXTerminal, sakura, Terminator, xfce4-terminal, and other libvte-based terminals (bug report)
upterm
ZOC (macOS)

Editor support

Works Doesn’t work
Abricotine Arduino IDE
Android Studio (2.3+, instructions) Adobe Dreamweaver
Anjuta (unless at the EOF) Delphi IDE
AppCode (2016.2+, instructions) Eclipse (Win, vote here)
Atom 1.1 or newer (instructions) Standalone Emacs (workaround)
BBEdit/TextWrangler (v. 11 only, instructions) gVim (Windows workaround)
Brackets (with this plugin) IDLE
Chocolat KDevelop 4
CLion (2016.2+, instructions) Monkey Studio IDE
Cloud9 (instructions)
Coda 2
CodeLite
Eclipse (Mac 4.7+, Linux)
elementary Code
Geany
gEdit / Pluma
GNOME Builder
IntelliJ IDEA (2016.2+, instructions)
Kate, KWrite
Komodo
Leafpad
LibreOffice
LightTable (instructions)
LINQPad
MacVim 7.4 or newer (instructions)
Mancy
Meld
Mousepad
NeoVim-gtk
NetBeans
Notepad (Win)
Notepad++ (with a workaround)
PhpStorm (2016.2+, instructions)
PyCharm (2016.2+, instructions)
QtCreator
Rider
RStudio (instructions)
RubyMine (2016.2+, instructions)
Scratch
SublimeText (3146+)
Spyder IDE (only with Qt5)
SuperCollider 3
TextAdept (Linux, Mac)
TextEdit
TextMate 2
VimR (instructions)
Visual Studio 2015
Visual Studio 2017
Visual Studio Code (instructions)
WebStorm (2016.2+, instructions)
Xamarin Studio/Monodevelop
Xcode (8.0+, otherwise with plugin)
Probably work: Smultron, Vico Under question: Code::Blocks IDE

Browser support

<!-- HTML -->
<link rel="stylesheet" href="https://cdn.rawgit.com/tonsky/FiraCode/1.206/distr/fira_code.css">
/* CSS */
@import url(https://cdn.rawgit.com/tonsky/FiraCode/1.206/distr/fira_code.css);
  • IE 10+, Edge: enable with font-feature-settings: "calt" 1;
  • Firefox
  • Safari
  • Chromium-based browsers (Chrome, Opera)
  • ACE
  • CodeMirror (enable with font-variant-ligatures: contextual;)

Projects using Fira Code

Alternatives

Other monospaced fonts with ligatures:

Credits

Why Fura and not Fira?

What's in a name? The reason for the name change is to comply with the SIL Open Font License (OFL), in partcular the Reserved Font Name mechanism

Some fonts have parts of their name "reserved" per the Reserved Font Name mechanism:

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 for additional information

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.