rustedf.cloud
Menu

Google Fonts em PDF: use font-family sem @font-face

Publicado em 3 min de leitura

Um PDF leva as suas fontes dentro do arquivo, então o documento fica igual em qualquer tela e em qualquer impressora. Em uma página web você escolhe uma fonte vinculando uma folha de estilo ou escrevendo @font-face. No renderizador do rustedf.cloud você não faz nenhuma das duas coisas: cita a família no CSS, e o serviço a encontra.

Cite a família

body { font-family: "Lato", sans-serif; }
h1 { font-family: "Playfair Display", serif; }

Qualquer família do Google Fonts funciona. O serviço lê os nomes das famílias no seu template e deixa as fontes disponíveis, então você não vincula a folha de estilo do Google Fonts nem escreve @font-face, e um @import copiado do código de incorporação é ignorado.

Termine a lista com uma família genérica, como sans-serif ou serif, como faria na web. Se a família não for encontrada, uma fonte embutida é usada no lugar dela.

O que acontece na primeira vez

O primeiro documento que usa uma família espera um instante enquanto a fonte é buscada. Depois disso ela fica guardada para todos, então a renderização seguinte é tão rápida quanto com qualquer outra fonte. Algumas regras decorrem disso:

  • A versão é fixa. Os arquivos de fonte vêm de uma versão fixa da coleção do Google Fonts, então um documento fica igual hoje e daqui a um ano.
  • Os nomes são tolerantes. As famílias são comparadas pelo nome, sem diferenciar maiúsculas, espaços e pontuação, então Playfair Display e playfairdisplay são a mesma família.
  • Há uma cota por hora. Cada conta pode trazer 30 famílias novas por hora, e as famílias já guardadas não custam nada. Passada a cota, o documento ainda é renderizado, com uma fonte embutida no lugar da nova.
  • A fonte viaja com o PDF. Qualquer fonte que um documento use fica embutida no arquivo.

Na prática, isso só importa se você renderiza muitos documentos com muitas famílias diferentes ao mesmo tempo, por exemplo quando cada cliente escolhe uma fonte. Uma fonte de marca fixa é buscada uma vez e fica.

As fontes embutidas

Todo documento também tem um conjunto base: Liberation, DejaVu e Noto para árabe, hebraico, devanágari, tailandês e outras escritas. A Liberation é compatível em métricas com Arial, Times New Roman e Courier New, então um layout escrito para essas fontes mantém as quebras de linha e de página.

As fontes embutidas são o recurso quando uma família não é encontrada, e cobrem o texto para o qual a fonte escolhida não tem glifos. Uma fonte sem letras árabes, por exemplo, ainda mostra texto em árabe com uma fonte Noto embutida.

Negrito e itálico

Nas famílias publicadas com um arquivo para cada estilo, como Lato, Poppins, Fira Sans, Ubuntu e Barlow, todos os pesos e itálicos que elas oferecem estão disponíveis.

Cerca de um terço das famílias do Google é publicado apenas como fonte variável, um único arquivo que cobre uma faixa de pesos. Inter, Roboto, Open Sans e Montserrat estão entre elas. O serviço desenha a instância que cada estilo pede, então font-weight e font-style se comportam nelas como nas demais:

h2 { font-family: "Inter", sans-serif; font-weight: 600; }
em { font-style: italic; }

O que não funciona

  • @font-face e @import. Os dois são ignorados e reportados. Cite a família.
  • Seus próprios arquivos de fonte. Uma fonte que não está no Google Fonts ainda não é suportada. Se um documento precisa de uma, veja se existe uma família do Google parecida.

Confira

Envie o documento para POST /v1/validate. Ele lista o que o serviço não conseguiu usar, inclusive texto em uma escrita que nenhuma fonte disponível cobre (TextShapingFailed), e não devolve PDF nem consome crédito. Depois abra o PDF renderizado e veja as propriedades no seu leitor: as fontes embutidas aparecem listadas ali.

Leia Fontes, Idiomas e formatação e HTML e CSS suportados.

← Todos os posts