beeware/toga

Add note clarifying font interpretation

已關閉

#4,479 建立於 2026年6月18日

 (1 則留言) (0 個反應) (0 位負責人)Python (624 個分叉)batch import
documentationgood first issue

倉庫指標

星標
 (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.


貢獻者指南