> 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/base-de-conhecimento/127-set-main-document.md).

# Definir documento principal

O documento principal no Overleaf é o ficheiro que o LaTeX será instruído a compilar primeiro. É o ficheiro principal do projeto, no qual todas as outras partes (classes, pacotes, capítulos, etc.) serão inseridas. Quando isto não é definido manualmente, o Overleaf escolherá um documento no projeto que inclui o **`\documentclass[...]{...}`** comando. Por este motivo, se tiver um ficheiro separado para o preâmbulo, é melhor não incluir o **`\documentclass[...]{...}`** comando no ficheiro do preâmbulo, mas sim no início do documento principal. Se não o fizer, apenas o preâmbulo será compilado. Para definir o documento principal num projeto, basta clicar no menu no canto superior esquerdo:

![MenuEsquerdo.PNG](/files/a8af31dc784f41f7c2c5ddce586b9cf21c08cde5)

e ir para **Documento principal**:

![Maindocument.PNG](/files/ff237062eb0b1cd63e738a0a8cbae73513de3fcf)

Veja [aqui](/latex/overleaf-learn-latex-pt/estrutura-do-documento/07-management-in-a-large-project.md) para saber mais sobre a gestão de projetos grandes em LaTeX.

## Compilar vários documentos no mesmo projeto

Para lhe permitir compilar rapidamente diferentes documentos no mesmo projeto, o Overleaf compilará como documento principal o ficheiro que estiver aberto no editor assim que este incluir o **`\documentclass[...]{...}`** comando. Isto é particularmente conveniente para editar com os [**`subficheiros`** pacote](/latex/overleaf-learn-latex-pt/estrutura-do-documento/08-multi-file-latex-projects.md#the-subfiles-package).

## Problemas com a seleção do ficheiro principal

O ficheiro principal deve estar sempre no diretório raiz (fora de quaisquer pastas), para garantir que todos os passos de compilação serão executados no diretório correto e para garantir que os ficheiros auxiliares necessários estejam disponíveis, por exemplo, quando [adicionar um índice](/latex/overleaf-learn-latex-pt/estrutura-do-documento/04-indices.md). Veja algumas dicas sobre como reorganizar o seu projeto para compilar no Overleaf [aqui](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/77-my-main-file-is-in-a-subfolder-but-this-is-not-allowed-on-overleaf.-but-i-don-t-want-to-change-my.md).

Se o ficheiro principal selecionado estiver contido numa pasta e existir um ficheiro com o mesmo nome no diretório raiz, o ficheiro com esse nome no diretório raiz será compilado em vez da seleção. Por exemplo, se `version1/main.tex` estiver definido como o ficheiro principal mas `main.tex` também estiver no projeto, `main.tex` será compilado. Este problema deve-se à forma como o Latexmk é executado no Overleaf. Para evitar problemas decorrentes disto, dê a quaisquer ficheiros que pretenda compilar no Overleaf um nome único.


---

# 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/base-de-conhecimento/127-set-main-document.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.