beeware/toga

Add note clarifying font interpretation

Chiusa

#4479 aperta il 18 giu 2026

 (1 commento) (0 reazioni) (0 assegnatari)Python (624 fork)batch import
documentationgood first issue

Metriche repository

Star
 (3615 stelle)
Metriche merge PR
 (Merge medio 5g) (64 PR mergiate in 30 g)

Descrizione

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.


Guida contributor