> 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/28-how-to-use-latexmkrc-with-overleaf.md).

# Como usar latexmkrc com o Overleaf

Mãos no ar se já ouviu falar de um `latexmkrc` ficheiro? Agora mantenha as mãos no ar se sabe o que ele faz. Agora mantenha as mãos no ar se alguma vez escreveu o seu próprio. Quem ainda estiver com as mãos no ar — provavelmente não precisa de ler o resto desta publicação.

Porque o interesse em `latexmkrc`? Temos recentemente recebido vários contactos de utilizadores a perguntar como fazer certas coisas no Overleaf, ao que a nossa resposta passou a ser: "Em primeiro lugar, crie um ficheiro personalizado `latexmkrc`  no seu projeto...". Tendo em conta que esta não é a parte mais intuitiva do LaTeX, e que a documentação na web (e os exemplos em particular) é bastante escassa, achámos que valia a pena explorá-la aqui com um pouco mais de detalhe.

### O que é um ficheiro latexmkrc?

Se nunca o viu antes, um `latexmkrc` ficheiro é um ficheiro de configuração/inicialização (RC) para o [`Latexmk` pacote](https://www.ctan.org/pkg/latexmk). `Latexmk` é usado pelo Overleaf para controlar a compilação do seu documento-fonte LaTeX no ficheiro PDF final composto. Ao usar um ficheiro de configuração personalizado chamado *`Latexmk`* pode substituir os comandos de compilação predefinidos para permitir que o Overleaf compile o seu documento de uma forma especial.

### Porque é que eu iria querer usar um ficheiro latexmkrc?

Bem, por exemplo, sabia que todas as datas e horas no PDF compilado no Overleaf são, por predefinição, as datas e horas do servidor. E se em vez disso quiser usar a sua data/hora local?

Para apresentar a data/hora local do seu fuso horário, pode alterar o `TZ` (variável de ambiente de fuso horário) usando um ficheiro personalizado `latexmkrc` ficheiro:

1. Na janela do editor do seu projeto, clique no ícone “Carregar” no topo do painel da árvore de ficheiros.
2. Selecione “Novo ficheiro” e dê ao ficheiro o nome `latexmkrc`.
3. Adicione a seguinte linha ao ficheiro `latexmkrc`:

   ```perl
   $ENV{'TZ'}='Canada/Central';
   ```

   ou qualquer outro fuso horário necessário. Aqui está uma [lista de fusos horários suportados para referência](http://php.net/manual/en/timezones.php).

Datas e horas (por ex. `\today` e `\currenttime` do `data/hora` pacote) no PDF deverá então fornecer valores locais ao fuso horário especificado.

Um `latexmkrc` ficheiro é muito útil para depurar um projeto que tenha erros fatais; leia mais sobre isso na [página de ajuda sobre tempo limite de compilação](/latex/overleaf-learn-latex-pt/base-de-conhecimento/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation).

### Onde posso encontrar mais exemplos de comandos latexmkrc?

Para começar, consulte os seguintes exemplos nas nossas páginas de ajuda:

* [Como é que o Overleaf compila o meu projeto?](/latex/overleaf-learn-latex-pt/base-de-conhecimento/064-how-does-overleaf-compile-my-project.md)
* [Posso executar TeX puro no Overleaf?](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/05-can-i-run-plain-tex-on-overleaf.md)
* [O Overleaf suporta pTeX?](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/09-does-overleaf-support-ptex.md)
* [Encontrar erros fatais de compilação que estão a bloquear a compilação](/latex/overleaf-learn-latex-pt/base-de-conhecimento/038-fixing-and-preventing-compile-timeouts.md#fatal-compile-errors-blocking-the-compilation)
* [Tenho muitos ficheiros .cls, .sty, .bst e quero colocá-los numa pasta para manter o meu projeto organizado. Mas o meu projeto não os está a encontrar para compilar corretamente.](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/59-i-have-a-lot-of-.cls-.sty-.bst-files-and-i-want-to-put-them-in-a-folder-to-keep-my-project-unclut.md)
* [Como posso fazer o pacote xr funcionar no Overleaf?](/latex/overleaf-learn-latex-pt/base-de-conhecimento/033-cross-referencing-with-the-xr-package-in-overleaf.md)
* [Como faço para que \today apresente a data de acordo com o meu fuso horário?](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/32-how-do-i-make-today-display-the-date-according-to-my-time-zone.md) (esse exemplo é reutilizado acima)

Se isso não ajudar, sinta-se à vontade para [página de contacto](https://www.overleaf.com/contact) ou experimente o popular [TeXStackExchange](http://tex.stackexchange.com) e [LaTeXCommunity](http://latex-community.org/) fóruns.


---

# 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/28-how-to-use-latexmkrc-with-overleaf.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.
