Um arquivo de fonte ao lado do projeto

Caminho do fontspec para famílias otf ou ttf locais.

Um arquivo de fonte ao lado do projeto

Suponha que sua tese use uma fonte que não está instalada em todas as máquinas que algum dia vão compilá-la: o notebook de um coautor, um servidor de build da universidade ou o seu próprio computador depois de uma reinstalação. Instalar a fonte no sistema de cada uma delas é frágil e às vezes nem é permitido. Coloque os arquivos de fonte na pasta do projeto e aponte o fontspec para eles, de modo que o documento carregue a própria tipografia. Isso exige XeLaTeX ou LuaLaTeX, já que o fontspec não funciona no pdfLaTeX. Os motivos estão em por que as pessoas migram para o XeLaTeX.

\usepackage{fontspec}
\setmainfont{MyFont}[
Path = ./fonts/,
Extension = .otf,
UprightFont = *-Regular,
BoldFont = *-Bold,
ItalicFont = *-Italic
]

O que cada chave faz

\setmainfont{MyFont} declara a família principal do texto e dá a ela o nome-base usado para montar os nomes dos arquivos. Path = ./fonts/ diz ao fontspec para procurar os arquivos em uma pasta fonts dentro do projeto, relativa ao arquivo .tex principal, em vez de perguntar ao sistema operacional. Extension = .otf informa o tipo de arquivo uma única vez, para que não precise ser repetido em cada arquivo. Use .ttf se for o que você tem.

As demais chaves associam estilos de fonte a arquivos. Em cada uma, o * se expande para o nome-base, então UprightFont = *-Regular resolve para MyFont-Regular.otf, e do mesmo modo MyFont-Bold.otf e MyFont-Italic.otf. Esses nomes precisam corresponder exatamente aos nomes reais dos arquivos, inclusive nas maiúsculas e minúsculas, porque a diferença importa em servidores Linux mesmo quando o seu sistema local a perdoa. Se a família tem um negrito itálico, adicione BoldItalicFont = *-BoldItalic. Um estilo que você não mapeia é um estilo que o documento não pode usar: sem a linha BoldFont, o \textbf não tem para onde mudar, e o compilador avisa que o estilo negrito está indefinido.

A mesma sintaxe vale para as outras famílias, então \setsansfont e \setmonofont aceitam blocos de opções idênticos para uma fonte sem serifa ou de código local.

Licenciamento e portabilidade

Distribua os arquivos de fonte com o projeto somente se a licença permitir a redistribuição. Licenças abertas como a SIL Open Font License permitem, e as fontes do Google Fonts geralmente se qualificam, mas fontes comerciais costumam proibir a entrega de cópias a colaboradores; nesse caso, cada máquina precisa da sua própria cópia licenciada, e você deve documentar esse requisito no readme do projeto.

O erro comum é uma divergência silenciosa entre os nomes declarados e os arquivos, geralmente depois de renomear a pasta ou de baixar um peso com nome diferente. A compilação então para com a mensagem “The font ‘MyFont-Regular’ cannot be found”. Quando isso acontecer, compare o nome de arquivo esperado pelo erro, caractere por caractere, com o conteúdo da pasta e confirme que o Path ainda aponta para onde os arquivos estão. Como o motor Tectonic embutido no Oleafly é baseado em XeTeX, esse padrão local ao projeto funciona lá sem instalar fontes no sistema.

Voltar para Fontes