仓库指标
- 星标
- (3,615 个星标)
- PR 合并指标
- (平均合并 5天) (30 天内合并 64 个 PR)
描述
What kind of documentation issue is this?
Unclear or confusing documentation
Affected page
https://toga.beeware.org/en/stable/reference/api/resources/font/#notes
Describe the issue
As discussed in #2159, the note about font usage on iOS and macOS is misleading. It's not that iOS and macOS can't use variant fonts - it's that iOS and macOS will only use variants that are actually in a font file.
Suggested improvement
We should replace the note about iOS/macOS font usage with the following:
Some platforms allow the use of font weights and variants that aren't explicitly provided by altering the rendering of a normal font (e.g., using a thick pen to render a normal font to render a fake bold, or applying a skew to render a fake italic). Toga only guarantees that the font faces, variants and weights that are actually defined in a font file will be available for use.