跳到主要内容
版本：2.20.0-SNAPSHOT

站点设置

基本设置​

Halo 提供了以下站点基本信息设置：

  • 站点标题
  • 站点副标题
  • Logo
  • Favicon

在控制台设置完成后，主题端可以通过特定的表达式获取到这些信息并且在对应的位置进行展示。具体是否读取使用这些配置、在哪些位置显示这些信息由使用的不同主题而决定。

以 Halo 2.0 的默认主题 Earth 为例，这些设置信息将在如下位置进行展示。

默认主题基本设置说明

文章设置​

针对主题端的文章展示，Halo 提供了以下设置项：

  • 文章列表显示条数：首页的文章显示条数。
  • 归档页文章显示条数：归档页面（/archives）的文章显示条数。
  • 分类页文章显示条数：分类归档页面（/categories/{slug}）的文章显示条数。
  • 标签页文章显示条数：标签归档页面（/tags/{slug}）的文章显示条数。
  • 别名生成策略：
    • 根据标题：自动根据文章标题生成，比如文章标题为 Hello Halo，那么别名将生成为 hello-halo
    • 时间戳：使用当前时间的时间戳作为标题
    • Short UUID：生成类似于 BT5kIgrb 的别名
    • UUID：生成类似于 4f662408-ed90-470b-9ed1-7fdc0283631b 的别名
  • 附件存储策略：在编辑器中上传图片时的附件存储策略
  • 附件存储组：在编辑器中上传图片时的附件分组

SEO 设置​

针对站点的 SEO（搜索引擎优化）需求，Halo 提供了以下设置项：

  • 屏蔽搜索引擎：配置后会在所有页面 HTML 源码的 head 部分添加：

    <meta name="robots" content="noindex" />
    信息

    需要注意的是，并不是所有搜索引擎都会遵守这个规则。

  • 站点关键词：格式为以 , 分隔的关键词列表，配置后会在所有页面 HTML 源码的 head 部分添加：

    <meta name="keywords" content="{关键词 A,关键词 B}" />
    注意

    目前主流的搜索引擎（如 Google、Bing、百度搜索等）已经不再使用该标签作为关键词的参考，因此该设置项的作用已经不大，未来我们也可能会移除该设置项。

  • 站点描述：配置后会在所有页面 HTML 源码的 head 部分添加：

    <meta name="description" content="{描述}" />

用户设置​

  • 开放注册：是否允许访客注册，勾选之后在登录页面会显示注册入口。
  • 注册需验证邮箱：开启之后，用户注册时必须要经过邮箱验证，需要配置好 邮件通知。
  • 默认角色：新注册用户的默认角色。
  • 头像存储位置：用户上传头像的存储策略。
  • 个人中心附件存储位置：用户在个人中心端上传附件时的默认存储策略，需要用户包含上传附件的权限。

评论设置​

针对站点的评论功能，Halo 提供了以下设置项：

  • 启用评论：全局评论功能开关配置，修改后影响所有文章、页面的评论功能。
  • 新评论审核：新增的评论是否需要在控制台进行审核，审核通过后其他访问者才能看到该条评论。
  • 仅允许注册用户评论：开启后只有登录用户才能添加评论，关闭后匿名（未登录）的访客也可以通过自行填写昵称、邮箱、网址等信息进行评论。

主题路由设置​

针对访问站点各种类型页面的 URL 生成规则，Halo 提供了以下主题路由设置项：

  • 分类页路由前缀：定位到分类列表页面以及分类归档页面。
    • 默认的分类列表页面 URL 规则前缀为 /categories
    • 默认的分类归档页面 URL 规则前缀为 /categories/{slug}
  • 标签页路由前缀：定位到标签列表页面以及标签归档页面。
    • 默认的标签列表页面 URL 规则前缀为 /tags
    • 默认的标签归档页面 URL 规则前缀为 /tags/{slug}
  • 归档页路由前缀：定位到文章归档页面的 URL 规则前缀，默认为 /archives。
  • 文章详情页访问规则：定位到具体文章详情页面的 URL 规则前缀，默认为 /archives/{slug} ，用户可从以下路径规则进行选择：

    • /archives/{slug}

    • /archives/{name}

    • /?p={name}

    • /?p={slug}

    • /?p={slug}

    • /{year}/{slug}

    • /{year}/{month}/{slug}

    • /{year}/{month}/{day}/{slug}

      变量说明
      • slug：文章别名
      • name：文章 metadata.name 字段值
      • year：四位数格式的文章发布年份
      • month：两位数格式的文章发布月份
      • day：两位数格式的文章发布日

代码注入​

你可以使用代码注入功能，在特定类型的页面中注入额外的代码。你可以通过该功能覆盖或补充部分主题 CSS 样式，或者引入额外的 JavaScript 脚本扩展主题端功能。

  • 全局 head 标签：该代码将会被注入到所有页面的 head 标签中。
  • 内容页 head 标签：该代码将会被注入到文章、页面详情页的 head 标签中。
  • 页脚：该代码将会被注入到所有页面的页脚中。

通知设置​

从 2.10.0 版本开始， Halo 提供了 通知 功能，当有新的评论、留言、回复等事件发生时，Halo 会通过配置的方式通知站长或者相关用户。同时，个人中心配置的电子邮箱也会作为通知的接收邮箱。

邮件通知​

  • 启用邮件通知器：开启后，当有新的评论、留言、回复等事件发生时，Halo 会通过 邮件 的方式通知站长或者相关用户。
  • 用户名：你需要在此处填写你的 邮箱账号。
  • 密码：你需要在此处填写你的 邮箱密码 或相关的 授权码，具体请参考你所使用邮箱的相关说明。
  • 显示名称：你需要在此处填写你的 邮箱显示名称，该名称将会作为邮件发送者的名称显示。
  • SMTP 服务器地址：你需要在此处填写你的 SMTP 服务器地址，具体请参考你所使用邮箱的相关说明。
  • 端口号：你需要在此处填写你的 SMTP 服务器端口号，具体请参考你所使用邮箱的相关说明。
  • 加密方式：你需要在此处选择你的 SMTP 服务器加密方式，具体请参考你所使用邮箱的相关说明。

常见邮箱服务商的文档如下：