品牌化

页眉

在本节中，我们将介绍如何个性化本地部署实例的关键元素。您可以根据偏好自定义站点标题、导航链接、页眉、页脚和徽标。

站点标题

导航栏标题可以通过环境变量自定义为 OVERLEAF_NAV_TITLE ，如果未设置徽标，此文本将显示在导航的左上角。

# 添加到 config/variables.env
OVERLEAF_NAV_TITLE=我们的 Overleaf 实例

徽标

您可以通过设置环境变量添加自定义徽标，而不是使用文本，变量为 OVERLEAF_HEADER_IMAGE_URL。此值应指向托管在外部的图像文件。

添加到 config/variables.env：

config/variables.env

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

页眉导航链接

可以通过将环境变量设置为 JSON 对象数组来向导航页眉添加额外的导航项，变量为 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"\
      }\
    ]\
  }\
]

将转义的 JSON 形式添加到 toolkit/variables.env：

toolkit/variables.env

# 添加到 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"}]}]

页脚

可以使用环境变量自定义左侧和较小的右侧页脚（出现在诸如 /project之类的页面上）， OVERLEAF_LEFT_FOOTER 和 OVERLEAF_RIGHT_FOOTER。两者都期望插入一个 JSON 对象数组。

两者都期望插入一个 JSON 数组。

[\
  {\
    "text": "这是一个示例文本页脚条目！"\
  },\
  {\
    "text": "这是一个示例 URL 页脚链接！", "url" : "/my-first-link.htm"\
  }\
]

当使用 text 时，仅限文本，不得包含 HTML，因为该值将作为原始文本渲染。

此数据需要是有效的 JSON 才能生效，作为环境变量传递时需要对引号进行转义。

config/variables.env

# 添加到 config/variables.env
OVERLEAF_LEFT_FOOTER=[{"text": "这是一个示例文本页脚条目！"}]
OVERLEAF_RIGHT_FOOTER=["text": "这是一个示例 URL 页脚链接！", "url" : "/my-first-link.htm"]

除了 text 和 url, JSON 对象还接受属性 class 和 label 以进行额外的自定义。