FiraCode/README.md

188 wiersze
7.5 KiB
Markdown
Czysty Zwykły widok Historia

2014-11-11 19:47:04 +00:00
## Fira Code: monospaced font with programming ligatures
2017-03-20 08:50:13 +00:00
<img src="http://s.tonsky.me/imgs/fira_code_logo.svg">
2015-07-30 12:27:45 +00:00
2014-11-11 19:47:04 +00:00
### Problem
2016-04-01 12:45:12 +00:00
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 thats not the case yet.
2014-11-11 19:47:04 +00:00
### Solution
2018-09-30 21:49:38 +00:00
#### [Download v1.206](https://github.com/tonsky/FiraCode/releases/download/1.206/FiraCode_1.206.zip) · [How to install](https://github.com/tonsky/FiraCode/wiki) · [Troubleshooting](https://github.com/tonsky/FiraCode/wiki#troubleshooting) · [News & updates](https://twitter.com/FiraCode)
2015-12-21 07:29:09 +00:00
2018-09-18 19:39:18 +00:00
<a href="https://patreon.com/tonsky" target="_blank"><img src="./fira_code_patreon.png"></a>
2016-03-24 01:24:28 +00:00
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.
2014-11-11 19:47:04 +00:00
2017-09-28 12:13:33 +00:00
<img src="./showcases/all_ligatures.png">
2014-11-11 19:47:04 +00:00
2016-08-30 11:34:40 +00:00
### Code examples
Ruby:
2017-09-28 12:13:33 +00:00
<img src="./showcases/ruby.png">
2016-08-30 11:34:40 +00:00
JavaScript:
2017-09-28 12:13:33 +00:00
<img src="./showcases/javascript.png">
PHP:
<img src="./showcases/php.png">
2016-08-30 11:34:40 +00:00
Erlang:
2017-09-28 12:13:33 +00:00
<img src="./showcases/erlang.png">
2016-08-30 11:34:40 +00:00
Elixir:
2017-09-28 12:13:33 +00:00
<img src="/showcases/elixir.png">
2016-08-30 11:34:40 +00:00
Go:
2017-09-28 12:13:33 +00:00
<img src="./showcases/go.png">
2016-08-30 11:34:40 +00:00
LiveScript:
2017-09-28 12:13:33 +00:00
<img src="./showcases/livescript.png">
2016-08-30 11:34:40 +00:00
Clojure:
2017-09-28 12:13:33 +00:00
<img src="./showcases/clojure.png">
2016-08-30 11:34:40 +00:00
Swift:
2017-08-07 13:27:23 +00:00
2017-09-28 12:13:33 +00:00
<img src="./showcases/swift.png">
2016-08-30 11:34:40 +00:00
2016-03-24 01:24:28 +00:00
### Terminal support
2015-12-20 14:51:56 +00:00
2017-11-02 10:27:48 +00:00
| Works | Doesnt work |
| ------------------ | ------------------ |
| **Butterfly** | **Alacritty** |
| **Hyper.app** | **cmd.exe** |
2018-07-04 09:10:26 +00:00
| **iTerm 2** ([3.1+](https://gitlab.com/gnachman/iterm2/issues/3568#note_13118332)) | **Cmder** |
2017-11-19 09:18:31 +00:00
| **Kitty** | **ConEmu** |
| **Konsole** | **GNOME Terminal** |
| **mintty** (partial support [2.8.3+](https://github.com/mintty/mintty/issues/601))| **mate-terminal** |
2018-07-04 09:10:26 +00:00
| **QTerminal** | **PuTTY** |
| **Terminal.app** | **rxvt** |
| **Termux** | **ZOC** (Windows) |
| **Token2Shell/MD** | **gtkterm, guake, LXTerminal, sakura, Terminator, xfce4-terminal,** and other libvte-based terminals ([bug report](https://bugzilla.gnome.org/show_bug.cgi?id=584160)) |
| **upterm** |
| **ZOC** (macOS) |
2015-12-20 14:51:56 +00:00
2014-11-11 19:47:04 +00:00
### Editor support
| Works | Doesnt work |
| ----- | -------------- |
| **Abricotine** | **Arduino IDE** |
| **Android Studio** (2.3+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | **Adobe Dreamweaver** |
| **Anjuta** (unless at the EOF) | **Delphi IDE** |
| **AppCode** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | **Eclipse** (Win, [vote here](https://bugs.eclipse.org/bugs/show_bug.cgi?id=398656)) |
| **Atom** 1.1 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/Atom-instructions)) | Standalone **Emacs** ([workaround](https://github.com/tonsky/FiraCode/wiki/Emacs-instructions)) |
| **BBEdit/TextWrangler** (v. 11 only, [instructions](https://github.com/tonsky/FiraCode/wiki/BBEdit-instructions)) | **gVim** (Windows [workaround](https://github.com/tonsky/FiraCode/issues/462)) |
| **Brackets** (with [this plugin](https://github.com/polo2ro/firacode-in-brackets)) | **IDLE** |
| **Chocolat** | **KDevelop 4** |
| **CLion** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | **Monkey Studio IDE** |
| **Cloud9** ([instructions](https://github.com/tonsky/FiraCode/wiki/Cloud9-Instructions)) | |
| **Coda 2** | |
| **CodeLite** | |
2017-08-07 13:50:25 +00:00
| **Eclipse** (Mac 4.7+, Linux) | |
2018-05-02 14:39:10 +00:00
| **elementary Code** | |
| **Geany** |
| **gEdit / Pluma** |
| **GNOME Builder** |
| **GoormIDE** ([instructions](https://github.com/tonsky/FiraCode/wiki/GoormIDE-Instructions)) |
| **IntelliJ IDEA** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) |
| **Kate, KWrite** |
| **Komodo** |
| **Leafpad** |
| **LibreOffice** |
| **LightTable** ([instructions](https://github.com/tonsky/FiraCode/wiki/LightTable-instructions)) |
| **LINQPad** |
| **MacVim** 7.4 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/MacVim-instructions)) |
| **Mancy** |
| **Meld** |
| **Mousepad** |
2018-03-13 09:51:38 +00:00
| **NeoVim-gtk** |
| **NetBeans** |
| **Notepad** (Win) |
| **Notepad++** (with a [workaround](https://github.com/notepad-plus-plus/notepad-plus-plus/issues/2287#issuecomment-256638098)) |
| **PhpStorm** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) |
| **PyCharm** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) |
| **QtCreator** |
| **Rider** |
| **RStudio** ([instructions](https://github.com/tonsky/FiraCode/wiki/RStudio-instructions)) |
| **RubyMine** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) |
| **Scratch** |
2019-01-02 16:22:28 +00:00
| **Scribus** (1.5.3+) |
| **SublimeText** (3146+) |
2017-03-30 13:23:15 +00:00
| **Spyder IDE** (only with Qt5) |
| **SuperCollider 3** |
| **TextAdept** (Linux, Mac) |
| **TextEdit** |
| **TextMate 2** |
| **VimR** ([instructions](https://github.com/qvacua/vimr/wiki#ligatures)) |
2017-04-27 11:45:41 +00:00
| **Visual Studio 2015** |
2018-11-14 21:14:09 +00:00
| **Visual Studio 2017** ([instructions](https://github.com/tonsky/FiraCode/wiki/Visual-Studio-2017-Instructions)) |
| **Visual Studio Code** ([instructions](https://github.com/tonsky/FiraCode/wiki/VS-Code-Instructions)) |
| **WebStorm** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) |
| **Xamarin Studio/Monodevelop** |
2017-08-07 13:27:23 +00:00
| **Xcode** (8.0+, otherwise [with plugin](https://github.com/robertvojta/LigatureXcodePlugin)) |
| Probably work: **Smultron, Vico** | Under question: **Code::Blocks IDE** |
2014-11-11 19:47:04 +00:00
### Browser support
2015-05-07 14:41:30 +00:00
```html
<!-- HTML -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/tonsky/FiraCode@1.206/distr/fira_code.css">
```
```css
/* CSS */
@import url(https://cdn.jsdelivr.net/gh/tonsky/FiraCode@1.206/distr/fira_code.css);
```
```css
/* Specify in CSS */
font-family: 'Fira Code', monospace;
```
2015-12-20 11:15:24 +00:00
- IE 10+, Edge: enable with `font-feature-settings: "calt" 1;`
- Firefox
2015-12-20 08:20:33 +00:00
- Safari
- Chromium-based browsers (Chrome, Opera)
2015-12-21 20:12:16 +00:00
- ACE
- CodeMirror (enable with `font-variant-ligatures: contextual;`)
2016-07-18 15:02:34 +00:00
2017-02-15 19:07:49 +00:00
### Projects using Fira Code
- All [JetBrains products](https://www.jetbrains.com/)
2017-02-16 09:17:37 +00:00
- [CodePen](https://codepen.io/)
2017-02-15 19:07:49 +00:00
- [Blink Shell](http://www.blink.sh/)
- [Klipse](http://app.klipse.tech/)
- [IlyaBirman.net](http://ilyabirman.net/)
- [EvilMartians.com](https://evilmartians.com/)
- [Web Maker](https://webmakerapp.com/)
- [FromScratch](https://fromscratch.rocks/)
- [PEP20.org](https://pep20.org/)
2016-07-18 15:02:34 +00:00
### Alternatives
2016-02-09 04:15:29 +00:00
Other monospaced fonts with ligatures:
- [Hasklig](https://github.com/i-tu/Hasklig) (free)
- [PragmataPro](http://www.fsd.it/fonts/pragmatapro.htm) (€59)
- [Monoid](http://larsenwork.com/monoid/) (free)
2016-05-06 10:50:37 +00:00
- [Fixedsys Excelsior](https://github.com/kika/fixedsys) (free)
- [Iosevka](https://be5invis.github.io/Iosevka/) (free)
- [DejaVu Sans Code](https://github.com/SSNikolaevich/DejaVuSansCode) (free)
2014-11-11 19:47:04 +00:00
### Credits
2016-04-16 15:16:36 +00:00
- Author: Nikita Prokopov [@nikitonsky](https://twitter.com/nikitonsky)
- Based on: [Fira Mono](https://github.com/mozilla/Fira)
- Inspired by: [Hasklig](https://github.com/i-tu/Hasklig)