Clarify Step 2 of font debugging

patrick96 2020-03-24 21:17:25 +01:00
parent 3673920a0b
commit 791d4fb18d
No known key found for this signature in database
GPG Key ID: 521E5E03AEBCA1A7
1 changed files with 9 additions and 2 deletions

@ -40,8 +40,15 @@ Follow these steps very carefully and in the order they are given and do not ski
1. **Confirm all fonts are loaded properly:**
To do that, follow the instructions in the [Finding Font Names](#finding-font-names) section.
2. **Check that all the icons you use are available in the fonts used:**
Use `gucharmap` to search (`Ctrl-F`) for the dropped characters (copy them from the terminal output), then switch to each font in your config, using the dropdown in the top left. For each font hold down right click on the highlighted character to show which font it's from. If that never shows any font from your config, you'll need to add the font for that character to your config.
2. **Check that all the icons you use are available in the fonts used:**
Use `gucharmap` and enable `View > Show only glyphs from this font` (**this is
important**), then search (`Ctrl-F`) for the dropped characters (copy them from
the terminal output), then switch to each font in your config, using the
dropdown in the top left.
If the desired icon never shows up, none of the fonts in your polybar config support that icon.
To find a font that provides that icon, we suggest you use the [perl
script](#find-fonts-for-glyphs) at the bottom of this page.
Another way is to disable `Show only glyphs from this font` in `gucharmap`, the icon should now show up again, if it doesn't you don't have any font on your system that supports that icon. If it does show up, you can hold right click and it will show you the font it's from in the tooltip.
3. **Check font order:** If you have no more **`Dropping unmatched character`** warnings but the wrong icons are displayed, you may have a font conflict where two fonts provide a font icon in the same position (codepoint). Make sure that none of the fonts in the font list, before the font that the icon is from, have a character at the same position.
You can do that by changing the order in which you define the fonts, although this can lead to conflicts in the other direction. The safest way is to use the `-font` property or the `%{T}` tag to specify which font to use, as described at the beginning of this page.