Skip to content
On this page

在后端控制前端

你可以在后端完全控制前端界面的行为(包括设定前端的配置),我们推荐使用这种方式部署 Artalk,并且这个特性「默认开启」。

如何修改前端配置

在侧边栏的控制中心提供了图形设置界面,你能快速轻松地对前端配置进行修改。

在前端引入内置资源

后端 Artalk 服务器中内置了可供前端引入的 JS 和 CSS 资源文件:

html
<!-- CSS -->
<link href="https://<artalk_go_server>/dist/Artalk.css" rel="stylesheet">

<!-- JS -->
<script src="https://<artalk_go_server>/dist/Artalk.js"></script>
<!-- CSS -->
<link href="https://<artalk_go_server>/dist/Artalk.css" rel="stylesheet">

<!-- JS -->
<script src="https://<artalk_go_server>/dist/Artalk.js"></script>

提示:将 <artalk_go_server> 替换为你的 Artalk 服务器地址。

这样能让前后端始终保持兼容性,而无需在程序升级后手动更换 Artalk 前端资源的引入地址。

进阶内容

手动编辑配置文件

Artalk 提供图形界面简化配置,一般情况无需手动修改。

在 Artalk 的配置文件 artalk.yml 中配置 frontend 字段来控制前端界面,例如:

yaml
frontend:
  placeholder: "键入内容..."
  noComment: "「此时无声胜有声」"
  sendBtn: "发送评论"
  emoticons: "https://raw.githubusercontent.com/ArtalkJS/Emoticons/master/grps/default.json"
  # ----- 此处省略 -------
  # 与前端配置项名称保持一致
frontend:
  placeholder: "键入内容..."
  noComment: "「此时无声胜有声」"
  sendBtn: "发送评论"
  emoticons: "https://raw.githubusercontent.com/ArtalkJS/Emoticons/master/grps/default.json"
  # ----- 此处省略 -------
  # 与前端配置项名称保持一致

一份完整的后端 frontend 字段配置文件可供参考:artalk.example.zh-CN.yml

关闭 “后端控制前端” 功能

后端控制前端功能默认开启,我们不建议关闭该功能。

在前端 Artalk.init({ ... }) 时定义的配置会被配置文件中的 frontend 字段配置所覆盖,但如果有需要也可以在前端禁用这个特性:

diff
Artalk.init({
+  useBackendConf: false,
})
Artalk.init({
+  useBackendConf: false,
})

表情包配置

建议 frontend.emoticons 填入表情包的 URL,而非 Object。

参考文档:“表情包”

如需传递 Object,可以将其转为 JSON 字符串格式,例如:

yaml
frontend:
  emoticons: '{"表情": { "test": "tttt..." }}'
frontend:
  emoticons: '{"表情": { "test": "tttt..." }}'