# Configurações do documento

Mude o tamanho do papel, as margens, a fonte, o idioma, o espaçamento entre linhas e a numeração em um diálogo que edita o preâmbulo LaTeX, as regras #set do Typst ou o front matter do Markdown.

Cada linguagem guarda a configuração de página em um lugar diferente: opções de classe e comandos de preâmbulo no LaTeX, regras `#set` no Typst, front matter no Markdown. As **Configurações do documento** dão a você um único formulário para todas elas. Quando você aplica, o Oleafly grava a alteração no seu arquivo principal como código-fonte comum, que você pode ler e editar depois.

Abra-as com o botão **Configurações do documento** na extremidade direita da barra de ferramentas do editor, ou execute **Configurações do documento** na paleta ⌘K (Ctrl+K). O diálogo sempre edita o documento principal do projeto, não importa qual arquivo esteja aberto.

## Os campos

O formulário tem quatro seções. Os campos dependem do motor:

| Seção | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| Página | Tamanho da página, Colunas, Margens | Tamanho da página, Margens, Colunas | Tipo de documento, Classe de documento, Tamanho da página, Colunas, Margens |
| Texto | Fonte do texto, Tamanho da fonte, Idioma | Fonte do texto, Tamanho da fonte, Idioma, Região | Fonte do texto, Tamanho da fonte, Idioma |
| Parágrafo | Espaçamento entre linhas | Justificação, Espaçamento entre linhas | Espaçamento entre linhas |
| Numeração | Níveis numerados, Numeração das equações | Numeração dos títulos, Numeração das equações | Números de seção |

As listas começam com **Padrão**, que remove a configuração para o padrão da classe, do modelo ou do motor valer de novo. Deixe um campo de texto vazio para o mesmo efeito. Comprimentos aceitam unidades, como `2.5cm`, `1in` ou `11pt`, e as margens do Typst também aceitam `auto`. Um valor que o Oleafly não consegue usar ganha uma nota curta sob o campo, e **Aplicar** espera até você corrigi-lo.

A **Fonte do texto** sugere fontes enquanto você digita. Em projetos Typst, a lista traz todas as fontes que o Typst consegue encontrar e diz de onde cada uma vem: a pasta `fonts` do projeto, o computador ou o conjunto embutido do Typst. Em projetos LaTeX e Markdown, ela lista as fontes instaladas no computador.

Escolha **Aplicar** para gravar as alterações, ou **Cancelar** para não mexer no arquivo. Quando o arquivo principal está aberto no editor, um único ⌘Z (Ctrl+Z) desfaz a alteração inteira.

## Para onde vão os valores

### LaTeX

- **Tamanho da página**, **Colunas** e **Tamanho da fonte** viram opções de `\documentclass`.
- As **Margens** vão para o pacote geometry. O Oleafly edita um `\geometry{…}` ou uma opção de geometry existente, ou adiciona `\usepackage[margin=…]{geometry}`.
- A **Fonte do texto** grava `\setmainfont{…}` e carrega a fontspec. Em um projeto latexmk, ela precisa do compilador XeLaTeX ou LuaLaTeX, e o campo avisa isso até você escolher um no menu de compilação ou o documento pedir um, por exemplo com uma linha `% !TeX program = xelatex`.
- O **Idioma** adiciona o idioma ao babel, usa `\setdefaultlanguage` quando o documento carrega a polyglossia, ou adiciona `\usepackage[language]{babel}`. Use nomes do babel, como `english`.
- O **Espaçamento entre linhas** é **Simples**, **Um e meio**, **Duplo** ou um número como `1.5`. Ele usa o pacote setspace, ou `\linespread` quando é isso que o documento já tem.
- Os **Níveis numerados** definem `secnumdepth`. Escolha **Nenhum**, **Só capítulos**, ou a profundidade da numeração, de **Até as seções** a **Até os subparágrafos**.
- A **Numeração das equações** grava `\numberwithin{equation}{…}` para **Por seção**, **Por capítulo** ou **Por subseção**.

### Typst

Os valores entram nas regras `#set` do arquivo principal. Quando falta uma regra, o Oleafly a adiciona perto do topo:

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, onde a **Justificação** é **Justificado** ou **Alinhado à esquerda**
- `#set heading(numbering: …)`, com padrões como `1.`, `1.1`, `1.a`, `I.` ou `A.`
- `#set math.equation(numbering: …)`, com `(1)`, `(1.1)` ou `1`

O **Idioma** aceita um código de duas ou três letras, como `en`, e a **Região** um código de duas letras, como `GB`.

Projetos Typst também ganham uma seção de **Variantes de compilação**. Cada variante é um conjunto nomeado de valores que o documento lê com `sys.inputs`, como uma versão de rascunho e a final. Use **Adicionar variante**, dê um nome a ela, depois adicione cada valor com **Adicionar valor**. Escolha a variante a compilar em **Variante (deste projeto)** no menu de compilação.

### Markdown

Os valores entram no front matter YAML que o Pandoc lê quando monta o PDF: `type`, `documentclass`, `papersize`, `classoption` para as colunas, `geometry` para as margens, `mainfont`, `fontsize`, `lang`, `linestretch` e `numbersections`. O **Tipo de documento** oferece **Artigo**, **Relatório ou tese**, **Livro**, **Slides**, **Pôster**, **Carta** e **Currículo**, e decide o que o documento compila. Veja [Tipos de documento](/docs/writing/markdown/#document-types). A **Classe de documento** oferece `article`, `report`, `book`, `scrartcl`, `scrreprt` e `memoir`. O **Idioma** aceita uma tag como `en-US`.

Onde você não definiu uma fonte, o Oleafly escolhe uma para cada escrita do documento, como coreano, árabe ou devanágari. O **Idioma** também decide qual fonte os caracteres chineses recebem: `ja` dá a fonte japonesa, `zh` o chinês simplificado e `zh-TW` o chinês tradicional. Veja [Texto em outros idiomas](/docs/writing/markdown/#text-in-other-languages).

Se o arquivo ainda não tem front matter, o diálogo avisa, e **Aplicar** adiciona um bloco no topo. Um front matter sem a linha `---` de fechamento precisa ser corrigido manualmente antes.

## Campos somente leitura

Alguns valores pertencem a outra coisa, e o diálogo os mostra em cinza com o motivo por baixo:

- **Definido pela classe …**: classes como `acmart`, `IEEEtran`, `llncs` e `beamer` fixam as próprias margens, e algumas também fixam o tamanho da página, o tamanho da fonte, as colunas, o espaçamento entre linhas ou o idioma. Uma nota no topo do diálogo nomeia a classe.
- **Definido pelo estilo …**: pacotes de estilo de conferência, como os de NeurIPS, ICML, ICLR, CVPR e ACL, definem o tamanho da página e as margens. Uma nota no topo do diálogo diz qual estilo está no comando.
- **O código define cada margem separadamente**: o documento informa as margens esquerda, direita, superior e inferior uma a uma, em vez de um único valor `margin`.
- **Definido dentro de um bloco condicional**: o valor está dentro de código `\if…`, então mudá-lo aqui poderia quebrar a lógica.
- **Definido pelo modelo**: no Typst, a regra `#set` que contém o valor tem uma condição `if` ou repassa argumentos `..`, como o código de modelo costuma fazer, então o diálogo não mexe nela.
- **Definido por uma expressão no código**: o valor é calculado, não escrito por extenso, então edite o código-fonte.

Quando um documento Typst aplica um modelo, uma nota no topo diz que valores definidos dentro do modelo não são mostrados, e que um valor definido aqui sobrepõe o modelo. No LaTeX, uma nota parecida aparece quando parte do preâmbulo vive em outros arquivos.

## Páginas relacionadas

- [Pacotes](/docs/packages/): adicione outros pacotes LaTeX ou Typst
- [Compilação](/docs/compiling/): escolha XeLaTeX ou LuaLaTeX, e selecione uma variante de compilação do Typst
- [Análise do documento](/docs/document-insights/): veja o que o documento contém
