tyler.durden/bottom
1
0
Fork 0
mirror of https://github.com/ClementTsang/bottom.git synced 2025-07-24 22:24:53 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: update font-related troubleshooting (#1695)

Browse Source
This commit is contained in:
Clement Tsang 2025-03-21 02:56:19 -04:00 committed by GitHub
parent 5e95f8fac8
commit 2afd32fbb0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 19 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/content/troubleshooting.md
View File

@ -23,18 +23,24 @@ Another (better) alternative is to install a font that supports braille fonts, a
For example, installing something like [UBraille](https://yudit.org/download/fonts/UBraille/) or [Iosevka](https://github.com/be5invis/Iosevka) For example, installing something like [UBraille](https://yudit.org/download/fonts/UBraille/) or [Iosevka](https://github.com/be5invis/Iosevka)
and ensuring your terminal uses it should work. and ensuring your terminal uses it should work.
### Braille font issues on Linux/macOS/Unix-like ### Linux/macOS/Unix
Generally, the problem comes down to you either not having a font that supports the braille markers, or your terminal If you're on a Unix-like system, generally, the problem comes down to you either not having a font that supports the
emulator is not using the correct font for the braille markers. braille markers, or your terminal emulator is not using the correct font for the braille markers.
See [here](https://github.com/cjbassi/gotop/issues/18) for possible fixes if you're having font issues on Linux, which Some possible solutions include:
may also be helpful for macOS or other Unix-like systems.
- Uninstalling `gnu-free-fonts` if installed, as that is known to cause problems with braille markers
- Installing a font like `ttf-symbola` or `ttf-ubraille` for your terminal emulator to try and automatically fall back to
- Configuring your terminal emulator to use specific fonts for the `U+2800` to `U+28FF` range.
- For example for kitty, do `symbol_map U+2800-U+28FF Symbola`.
See [this issue](https://github.com/cjbassi/gotop/issues/18) for more possible fixes.
If you're still having issues, feel free to open a [discussion](https://github.com/ClementTsang/bottom/discussions/new/) If you're still having issues, feel free to open a [discussion](https://github.com/ClementTsang/bottom/discussions/new/)
question about it. question about it.
### Installing fonts for Windows Command Prompt/PowerShell ### Windows/Powershell
**Note: I would advise backing up your registry beforehand if you aren't sure what you are doing!** **Note: I would advise backing up your registry beforehand if you aren't sure what you are doing!**
@ -50,16 +56,16 @@ Let's say you're installing [Iosevka](https://github.com/be5invis/Iosevka). The
4. Here, add a new `String value`, and set the `Name` to a bunch of 0's (e.g. `000` - make sure the name isn't already used), then set the `Data` to the font name (e.g. `Iosevka`). 4. Here, add a new `String value`, and set the `Name` to a bunch of 0's (e.g. `000` - make sure the name isn't already used), then set the `Data` to the font name (e.g. `Iosevka`).
<figure> <figure>
<img src="../assets/screenshots/troubleshooting/regedit_fonts.webp" alt="Regedit menu showing how to add a new font for Command Prompt/PowerShell"/> <img src="../assets/screenshots/troubleshooting/regedit_fonts.webp" alt="Regedit menu showing how to add a new font for Command Prompt/PowerShell"/>
<figcaption><sub>The last entry is the new entry for Iosevka</sub></figcaption> <figcaption><sub>The last entry is the new entry for Iosevka</sub></figcaption>
</figure> </figure>
5. Then, open the Command Prompt/PowerShell, and right-click on the top bar, and open "Properties": 5. Then, open the Command Prompt/PowerShell, and right-click on the top bar, and open "Properties":
<figure> <figure>
<img src="../assets/screenshots/troubleshooting/cmd_prompt_props.webp" alt="Opening the properties menu in Command Prompt/PowerShell"/> <img src="../assets/screenshots/troubleshooting/cmd_prompt_props.webp" alt="Opening the properties menu in Command Prompt/PowerShell"/>
</figure> </figure>
6. From here, go to "Font", and set the font to your new font (so in this example, Iosevka): 6. From here, go to "Font", and set the font to your new font (so in this example, Iosevka):