> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/zh-tw/she-ding/overleaf-toolkit/branding.md).

# 品牌化

### 標頭 <a href="#header" id="header"></a>

在本節中，我們將介紹如何個人化您的自架執行個體的主要元素。您可以根據自己的偏好自訂網站標題、導覽連結、標頭、頁尾和標誌。

### 網站標題 <a href="#site-title" id="site-title"></a>

導覽列標題可以使用 `OVERLEAF_NAV_TITLE` 環境變數來自訂；如果未設定標誌，則會在導覽列左上角使用此文字。

```bash
# 加入到 config/variables.env
OVERLEAF_NAV_TITLE=我們的 Overleaf 實例
```

## 標誌

您可以設定環境變數來加入自訂標誌，而不是使用文字 `OVERLEAF_HEADER_IMAGE_URL`。此值應指向外部代管的圖片檔案。

加入到 config/variables.env：

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

```bash
# 加入到 config/variables.env
OVERLEAF_HEADER_IMAGE_URL=https://mysite.somewhere.com/img/logo.png
```

{% endcode %}

## 標頭導覽連結

可透過設定 `OVERLEAF_HEADER_EXTRAS` 環境變數為 JSON 物件陣列，新增額外的導覽項目。例如：

{% code overflow="wrap" %}

```json
[\
  {\
    "text": "某個連結",\
    "url": "http://example.com/somelink",\
    "class": "subdued",\
    "only_when_logged_out": true\
  },\
  {\
    "text": "說明",\
    "class": "subdued",\
    "dropdown": [\
      {\
        "text": "文件",\
        "url": "/learn"\
      },\
      {\
        "text": "聯絡管理員",\
        "url": "http://example.com/contact"\
      }\
    ]\
  }\
]
```

{% endcode %}

將跳脫後的 JSON 形式加入 toolkit/variables.env：

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

```bash
# 加入到 toolkit/variables.env
OVERLEAF_HEADER_EXTRAS=[{"text":"某個連結","url":"http://example.com/somelink","class":"subdued","only_when_logged_out":true},{"text":"說明","class":"subdued","dropdown":[{"text":"文件","url":"/learn"},{"text":"聯絡管理員","url":"http://example.com/contact"}]}]
```

{% endcode %}

## 頁尾

可以自訂左側以及較小的右側頁尾（可在像是 `/project`）等頁面中找到），使用環境變數 `OVERLEAF_LEFT_FOOTER` 以及 `OVERLEAF_RIGHT_FOOTER`。兩者皆預期一個將被插入的 JSON 物件陣列。

兩者皆預期一個將被插入的 JSON 陣列。

```json
[\
  {\
    "text": "這是一個範例文字頁尾項目!"\
  },\
  {\
    "text": "這是一個範例 URL 頁尾連結!", "url" : "/my-first-link.htm"\
  }\
]
```

{% hint style="info" %}
使用 `text` 單獨使用時，它不得包含 HTML，因為該值將以原始文字呈現。
{% endhint %}

這些資料需要是有效的 JSON 才能運作，而且作為環境變數傳遞時，必須將引號跳脫。

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

```bash
# 加入到 config/variables.env
OVERLEAF_LEFT_FOOTER=[{"text": "這是一個範例文字頁尾項目!"}]
OVERLEAF_RIGHT_FOOTER=["text": "這是一個範例 URL 頁尾連結!", "url" : "/my-first-link.htm"]
```

{% endcode %}

{% hint style="info" %}
除了 `text` 以及 `url`，該 JSON 物件也接受以下屬性 `class` 以及 `label` 以進行額外自訂。
{% 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://ayakaleaf-pro.ayaka.space/on-premises/zh-tw/she-ding/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.
