Skip to content

Commit 1184f52

Browse files
committed
add font render issue to faq
1 parent edea4dc commit 1184f52

File tree

2 files changed

+22
-2
lines changed

2 files changed

+22
-2
lines changed

README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,10 +61,9 @@ where to look for certain things:
6161
- The [Technical Reference](/documentation/reference) documents APIs and other aspects of the
6262
machinery. This documentation describes how to use the classes and functions at a lower level
6363
and assume that you have a good high-level understanding of the software.
64-
<!--
6564
- The [Help](/documentation/help) guide provides a starting point and outlines common issues that you
6665
may have.
67-
-->
66+
6867

6968
## Install With PIP
7069

documentation/help/README.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
2+
# FAQs
3+
4+
**Q: Why does the font look off when using AnsiToImg, especially on Android or other platforms?**
5+
6+
AnsiToImg cannot meaningfully control the font used when rendering text, as it relies on the OS
7+
and the Playwright library (which uses the Chromium browser to render SVGs). This means that font
8+
rendering issues, such as alignment problems or incorrect fonts, are often caused by the system's
9+
font fallback mechanisms.
10+
11+
Android users may particularly notice this issue due to how Android handles font fallbacks.
12+
Unfortunately, this is not something AnsiToImg can directly control. The issue stems from upstream,
13+
meaning it would need to be resolved by the Android platform itself.
14+
15+
For more in-depth information about font fallback issues, I recommend reading articles by **Tonsky**,
16+
the creator of Fira Code. They explain these kinds of problems much better than I could. You can
17+
check out one of their posts here: [Font Size Article by Tonsky](https://tonsky.me/blog/font-size/).
18+
19+
Here's another example of a similar alignment issue in a different project:
20+
[Nushell Issue #83](https://github.com/nushell/nushell.github.io/issues/83). In that case, the
21+
developers also faced limitations due to upstream dependencies.

0 commit comments

Comments
 (0)