> 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/on-premises/pt/configuracao/overleaf-toolkit/branding.md).

# Identidade visual

### Cabeçalho <a href="#header" id="header"></a>

Nesta secção, abordaremos como personalizar os elementos principais da sua instância local. Pode personalizar o título do site, os links de navegação, o cabeçalho, o rodapé e o logótipo de acordo com as suas preferências.

### Título do site <a href="#site-title" id="site-title"></a>

O título da barra de navegação pode ser personalizado com a `OVERLEAF_NAV_TITLE` variável de ambiente; este texto é usado no canto superior esquerdo da navegação se não estiver definido nenhum logótipo.

```bash
# adicionar a config/variables.env
OVERLEAF_NAV_TITLE=A nossa instância Overleaf
```

## Logótipo

Pode adicionar um logótipo personalizado em vez de usar texto, definindo a variável de ambiente `OVERLEAF_HEADER_IMAGE_URL`. Este valor deve apontar para um ficheiro de imagem alojado externamente.

Adicionar a config/variables.env:

{% code title="config/variables.env" %}

```bash
# adicionar a config/variables.env
OVERLEAF_HEADER_IMAGE_URL=https://mysite.somewhere.com/img/logo.png
```

{% endcode %}

## Links de navegação do cabeçalho

É possível adicionar itens de navegação extra ao cabeçalho de navegação definindo a `OVERLEAF_HEADER_EXTRAS` variável de ambiente para um array JSON de objetos. Por exemplo:

{% code overflow="wrap" %}

```json
[\
  {\
    "text": "Algum link",\
    "url": "http://example.com/somelink",\
    "class": "subdued",\
    "only_when_logged_out": true\
  },\
  {\
    "text": "Ajuda",\
    "class": "subdued",\
    "dropdown": [\
      {\
        "text": "Documentação",\
        "url": "/learn"\
      },\
      {\
        "text": "Contactar o administrador",\
        "url": "http://example.com/contact"\
      }\
    ]\
  }\
]
```

{% endcode %}

Adicione a forma JSON escapada a toolkit/variables.env:

{% code title="toolkit/variables.env" overflow="wrap" %}

```bash
# adicionar a toolkit/variables.env
OVERLEAF_HEADER_EXTRAS=[{"text":"Algum link","url":"http://example.com/somelink","class":"subdued","only_when_logged_out":true},{"text":"Ajuda","class":"subdued","dropdown":[{"text":"Documentação","url":"/learn"},{"text":"Contactar o administrador","url":"http://example.com/contact"}]}]
```

{% endcode %}

## Rodapés

É possível personalizar tanto o rodapé esquerdo como o rodapé direito mais pequeno (encontrado em páginas como `/project`) usando as variáveis de ambiente `OVERLEAF_LEFT_FOOTER` e `OVERLEAF_RIGHT_FOOTER`. Ambos esperam um array de objetos JSON que será inserido.

Ambos esperam um array de JSON que será inserido.

```json
[\
  {\
    "text": "Esta é uma entrada de rodapé de texto de exemplo!"\
  },\
  {\
    "text": "Esta é uma ligação de rodapé de URL de exemplo!", "url" : "/my-first-link.htm"\
  }\
]
```

{% hint style="info" %}
Ao usar `texto` apenas, não deve conter HTML, pois o valor será renderizado como texto simples.
{% endhint %}

Estes dados precisam de ser JSON válido para funcionar, com as aspas escapadas quando passados através de uma variável de ambiente.

{% code title="config/variables.env" overflow="wrap" %}

```bash
# adicionar a config/variables.env
OVERLEAF_LEFT_FOOTER=[{"text": "Esta é uma entrada de rodapé de texto de exemplo!"}]
OVERLEAF_RIGHT_FOOTER=["text": "Esta é uma ligação de rodapé de URL de exemplo!", "url" : "/my-first-link.htm"]
```

{% endcode %}

{% hint style="info" %}
Além de `texto` e `url`, o objeto JSON também aceita as propriedades `class` e `rótulo` para personalização adicional.
{% endhint %}


---

# 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/on-premises/pt/configuracao/overleaf-toolkit/branding.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.