From ed26f07ffe916fad971198f5160486f75ab908f3 Mon Sep 17 00:00:00 2001 From: Nikita Prokopov Date: Sat, 10 Jun 2017 15:43:14 +0300 Subject: [PATCH] Troubleshooting & known issues --- Home.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 53 insertions(+), 1 deletion(-) diff --git a/Home.md b/Home.md index a68db02..7d7a9e5 100644 --- a/Home.md +++ b/Home.md @@ -1,5 +1,7 @@ ### How to enable ligatures +You need to explicitly enable ligatures support in following editors: + - [Atom](https://github.com/tonsky/FiraCode/wiki/Atom-instructions) - [Jetbrains' products](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions) (IntelliJ, etc) - [Emacs](https://github.com/tonsky/FiraCode/wiki/Setting-up-Emacs) @@ -24,4 +26,54 @@ Mac: Linux: - in the ttf folder, double-click each font file, click “Install font” -- if double-clicking doesn’t work, see [this page](https://github.com/tonsky/FiraCode/wiki/Linux-instructions) \ No newline at end of file +- if double-clicking doesn’t work, see [this page](https://github.com/tonsky/FiraCode/wiki/Linux-instructions) + +### Troubleshooting + +#### 1. Make sure the font your editor displays is actually Fira Code + +Easiest way to do that is to type `@&r` and compare them with the reference image: + +![](https://user-images.githubusercontent.com/285292/26971424-c609be76-4d15-11e7-8684-23e7b1c08929.png) + +Issues: [#393](https://github.com/tonsky/FiraCode/issues/393) [#373](https://github.com/tonsky/FiraCode/issues/373) [#227](https://github.com/tonsky/FiraCode/issues/227) + +#### 2. Make sure you’ve enabled ligatures in your editor + +Consult this wiki (see above) for instruction on how to do that. + +Issues: [#291](https://github.com/tonsky/FiraCode/issues/291) + +#### 3. Make sure you’re on the latest version of Fira Code + +Consult [CHANGELOG](https://github.com/tonsky/FiraCode/blob/master/CHANGELOG.md) to see when it was last updated. + +### Known issues + +#### Hinting issues + +* Uneven spacing in `===` and `!==` at certain font sizes, esp. on Windows [#405](https://github.com/tonsky/FiraCode/issues/405) [#243](https://github.com/tonsky/FiraCode/issues/243) [#119](https://github.com/tonsky/FiraCode/issues/119) [#114](https://github.com/tonsky/FiraCode/issues/114) + +* Different height of `[]` at certain font sizes [#332](https://github.com/tonsky/FiraCode/issues/332) [#251](https://github.com/tonsky/FiraCode/issues/251) + +#### Powerline characters are of slightly wrong size + +Unfortunately this can’t be fixed for all terminals because they have different ways of calculate font metrics. See [this comment](https://github.com/tonsky/FiraCode/issues/44#issuecomment-187305276) + +Issues: [#426](https://github.com/tonsky/FiraCode/issues/426) [#131](https://github.com/tonsky/FiraCode/issues/131) [#44](https://github.com/tonsky/FiraCode/issues/44) + +#### Some ligatures work while some don’t + +This is an issue with your editor and how it handles tokenization/syntax highlighting. Nothing can be done in a font to work around that. Report your problem to the corresponding editor’s issue tracker. + +- All ligatures with dashes in Visual Studio (not Code) [#422](https://github.com/tonsky/FiraCode/issues/422) [#395](https://github.com/tonsky/FiraCode/issues/395) [#360](https://github.com/tonsky/FiraCode/issues/360) [#273](https://github.com/tonsky/FiraCode/issues/273) [#259](https://github.com/tonsky/FiraCode/issues/259) [#233](https://github.com/tonsky/FiraCode/issues/233) [#220](https://github.com/tonsky/FiraCode/issues/220) [#196](https://github.com/tonsky/FiraCode/issues/196) [#181](https://github.com/tonsky/FiraCode/issues/181) [#157](https://github.com/tonsky/FiraCode/issues/157) [#99](https://github.com/tonsky/FiraCode/issues/99) [#43](https://github.com/tonsky/FiraCode/issues/43) [#32](https://github.com/tonsky/FiraCode/issues/32) + +- Ligatures in column 100 in VS Code [#403](https://github.com/tonsky/FiraCode/issues/403) [#397](https://github.com/tonsky/FiraCode/issues/397) [#372](https://github.com/tonsky/FiraCode/issues/372) + +- Atom/VS Code are known to break certain ligatures in certain syntaxes [#361](https://github.com/tonsky/FiraCode/issues/361) [#353](https://github.com/tonsky/FiraCode/issues/353) [#348](https://github.com/tonsky/FiraCode/issues/348) [#328](https://github.com/tonsky/FiraCode/issues/328) [#326](https://github.com/tonsky/FiraCode/issues/326) [#235](https://github.com/tonsky/FiraCode/issues/235) + +#### Anything related to italics + +Fira Code does not have italics at all. If you see italicized glyphs it means your editor is “faking” them. + +Issues: [#375](https://github.com/tonsky/FiraCode/issues/375) [#320](https://github.com/tonsky/FiraCode/issues/320) [#281](https://github.com/tonsky/FiraCode/issues/281) \ No newline at end of file