> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/artigos-aprofundados/37-step-1-setting-up-an-overleaf-project-to-use-variable-fonts.md).

# Passo 1: Configurar um projeto Overleaf para usar tipos de letra variáveis

[Introdução](https://www.overleaf.com/learn/latex/Articles/How_to_use_OpenType_variable_fonts_with_LaTeX?preview=true) [Passo 1](https://www.overleaf.com/learn/latex/Articles/Step_1:_Setting_up_an_Overleaf_project_to_use_variable_fonts?preview=true) [Passo 2](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) [Passo 3](https://www.overleaf.com/learn/latex/Articles/Step_3:_Replacing_LaTeX’s_default_fonts_with_variable_fonts?preview=true) [Passo 4](https://www.overleaf.com/learn/latex/Articles/Step_4:_How_to_configure_an_italic_variable_font_using_fontspec?preview=true) [Passo 5](https://www.overleaf.com/learn/latex/Articles/Step_5:_LaTeX_font_weights_and_named_instances_of_variable_fonts?preview=true) [Passo 6](https://www.overleaf.com/learn/latex/Articles/Step_6:_Using_variable_fonts_to_add_bold_fonts_to_an_Overleaf_project?preview=true) [Passo 7](https://www.overleaf.com/learn/latex/Articles/Step_7:_Using_Noto_Sans_and_Roboto_Mono_variable_fonts_with_LaTeX?preview=true) [Passo 8](https://www.overleaf.com/learn/latex/Articles/Step_8:_How_to_create_a_simple_LaTeX_package_to_configure_your_variable_fonts?preview=true) [Exemplos e projetos](https://www.overleaf.com/learn/latex/Articles/Overleaf_projects_showing_how_to_use_variable_fonts_with_LaTeX?preview=true)

Para começar este tutorial, abra o [projeto do Overleaf que o acompanha](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d) que contém as seguintes fontes variáveis:

* [Noto Serif](https://fonts.google.com/noto/specimen/Noto+Serif/tester) (texto principal do documento)
* [Noto Sans](https://fonts.google.com/noto/specimen/Noto+Sans/tester) (fonte sem serifa)
* [Roboto Mono](https://fonts.google.com/specimen/Roboto+Mono/tester) (fonte monoespaçada)

Estas fontes ainda não estão configuradas para utilização. Inicialmente, quando compilar o [projeto do Overleaf que o acompanha](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d), serão aplicadas as fontes de texto padrão (predefinidas) do LaTeX. Ao longo deste tutorial, aprenderá a substituir estas fontes predefinidas pelas fontes variáveis fornecidas na pasta do projeto chamada `VariableFonts`.

Se preferir usar diferentes fontes variáveis, basta seguir as instruções abaixo. Caso contrário, avance para [Passo 2](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) este tutorial.

## (Opcional) Como escolher e carregar as suas próprias fontes variáveis

Siga estes passos para carregar as fontes variáveis da sua escolha.

### 1. Obtenha fontes variáveis do Google Fonts

[Google Fonts](https://fonts.google.com/) é um excelente recurso. Fornece [documentação útil](https://fonts.google.com/knowledge/introducing_type/introducing_variable_fonts) e muitas [fontes variáveis de utilização gratuita](https://fonts.google.com/?vfonly=true) que podem ser carregadas no Overleaf e configuradas para utilização nos seus projetos.

* **DICA**: Use os filtros do Google Fonts para encontrar fontes variáveis. Defina o *Tecnologia* filtro para *Variável* para mostrar apenas fontes variáveis. Use filtros adicionais, como *Serifa*, para refinar ainda mais a sua pesquisa.

![Imagem que mostra os filtros de pesquisa do Google Fonts](/files/eccff42db40fdb82e8da7ea903bbd5210345ea3d)

* **DICA**: Pode explorar fontes variáveis com base nos eixos de design que suportam: consulte <https://fonts.google.com/variablefonts>. O Google também fornece definições dos eixos de design das fontes variáveis: consulte <https://fonts.google.com/variablefonts#axis-definitions>.
* Depois de localizar quaisquer fontes variáveis que queira utilizar, descarregue-as para o seu dispositivo local e renomeie quaisquer ficheiros que contenham caracteres problemáticos.
* Algumas fontes variáveis consistem em dois `.ttf` ficheiros: um para a forma direita (regular) e, se fornecido, um para a forma itálica. Certifique-se de verificar isto para cada fonte que descarregar.

### 2. Renomeie nomes de ficheiros de fontes Google problemáticos

O esquema do Google para nomear ficheiros de fontes variáveis inclui os eixos de design da fonte, separados por vírgulas. Infelizmente, esse esquema causa problemas ao fontspec, um pacote essencial para usar fontes variáveis com LuaLaTeX. Por exemplo, o Noto Serif fornece eixos de largura e peso e é fornecido em dois ficheiros—um para a fonte direita e um para a fonte itálica:

* NotoSerif-VariableFont\_wdth,wght.ttf
* NotoSerif-Italic-VariableFont\_wdth,wght.ttf

As vírgulas nestes nomes de ficheiro desencadeiam erros quando usados no comando `\setmainfont` do fontspec. Por exemplo, ao escrever

```
\setmainfont{NotoSerif-VariableFont_wdth,wght.ttf}
[ItalicFont = NotoSerif-Italic-VariableFont_wdth,wght.ttf]
```

gera erros que incluem

```
! Erro do pacote fontspec: A fonte "NotoSerif-Italic-VariableFont_wdth" não pode
(fontspec)                ser encontrada.

! Erro do LaTeX: A chave 'fontspec-opentype/wght.ttf' é desconhecida e está a ser
(LaTeX)        ignorada.
```

Para resolver este problema, tem de renomear os ficheiros de fonte para remover as vírgulas (e os sublinhados '\_'), substituindo-os por um caractere “seguro”, como os hífens ('-'), e garantindo que não são adicionados caracteres de espaço. Por exemplo, poderia renomear:

* NotoSans-VariableFont\_wdth,wght.ttf

para

* NotoSans-VariableFont-wdth-wght.ttf

Este simples passo de renomeação ajudará a evitar conflitos e garantirá uma integração tranquila de fontes variáveis nos seus documentos LaTeX.

### 3. Crie um novo projeto Overleaf

* Crie um novo projeto Overleaf e [defina o compilador para LuaLaTeX](/latex/overleaf-learn-latex-pt/base-de-conhecimento/026-changing-compiler.md) porque é o único compilador que suporta fontes variáveis.
* Adicione o `fontspec` pacote ao preâmbulo do seu documento escrevendo `\usepackage{fontspec}`.
* Selecione o ícone de carregamento de ficheiros (![Image displaying Overleaf file-upload icon](/files/0f94f605456b3c5c87c0064dfb7af865e2eae6b0)) para adicionar os ficheiros de fonte variável renomeados localmente ao seu novo projeto:

![Imagem que mostra como carregar um ficheiro para um projeto Overleaf](/files/7f62cf877f07b5db39d688b41634d95667ce7e6c)

### 4. (Opcional) organize os ficheiros de fonte do seu projeto

Se quiser experimentar uma variedade de fontes, por exemplo, ao testar designs de documentos, é útil organizar os seus ficheiros de fonte usando pastas do projeto. No entanto, no momento da compilação, o LaTeX não pesquisará automaticamente as pastas do seu projeto por fontes; terá de ajudar o LaTeX usando um ficheiro de configuração local chamado [latexmkrc](/latex/overleaf-learn-latex-pt/artigos-aprofundados/28-how-to-use-latexmkrc-with-overleaf.md). Não entraremos em detalhes aqui, mas recomendamos criar uma pasta do projeto chamada `VariableFonts` e copiar o `latexmkrc` ficheiro usado no [projeto que o acompanha](https://www.overleaf.com/8438931911svtqtnmfvsrp#28008d).

## No próximo passo

O Passo 2 introduz o modelo do LaTeX para selecionar fontes: o New Font Selection Scheme, fornecendo informações de contexto importantes usadas ao longo do restante deste tutorial.

[Introdução](https://www.overleaf.com/learn/latex/Articles/How_to_use_OpenType_variable_fonts_with_LaTeX?preview=true) [Passo 1](https://www.overleaf.com/learn/latex/Articles/Step_1:_Setting_up_an_Overleaf_project_to_use_variable_fonts?preview=true) [Passo 2](https://www.overleaf.com/learn/latex/Articles/Step_2:_An_introduction_to_LaTeX_fonts?preview=true) [Passo 3](https://www.overleaf.com/learn/latex/Articles/Step_3:_Replacing_LaTeX’s_default_fonts_with_variable_fonts?preview=true) [Passo 4](https://www.overleaf.com/learn/latex/Articles/Step_4:_How_to_configure_an_italic_variable_font_using_fontspec?preview=true) [Passo 5](https://www.overleaf.com/learn/latex/Articles/Step_5:_LaTeX_font_weights_and_named_instances_of_variable_fonts?preview=true) [Passo 6](https://www.overleaf.com/learn/latex/Articles/Step_6:_Using_variable_fonts_to_add_bold_fonts_to_an_Overleaf_project?preview=true) [Passo 7](https://www.overleaf.com/learn/latex/Articles/Step_7:_Using_Noto_Sans_and_Roboto_Mono_variable_fonts_with_LaTeX?preview=true) [Passo 8](https://www.overleaf.com/learn/latex/Articles/Step_8:_How_to_create_a_simple_LaTeX_package_to_configure_your_variable_fonts?preview=true) [Exemplos e projetos](https://www.overleaf.com/learn/latex/Articles/Overleaf_projects_showing_how_to_use_variable_fonts_with_LaTeX?preview=true)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/artigos-aprofundados/37-step-1-setting-up-an-overleaf-project-to-use-variable-fonts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
