beeware/toga

Add note clarifying font interpretation

Fechada

#4.479 aberto em 18 de jun. de 2026

 (1 comentário) (0 reação) (0 responsável)Python (624 forks)batch import
documentationgood first issue

Métricas do repositório

Stars
 (3.615 estrelas)
Métricas de merge de PR
 (Mesclagem média 5d) (64 fundiu PRs em 30d)

Description

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.


Guia do colaborador