Skip to content

前端部署

在 Hexo 中使用

Hexo Butterfly 主题使用

请参考 Butterfly 安裝文檔(四) 主題配置-2 进行配置

Hexo Keep 主题使用

请参考 hexo-theme-keep/_config.yml 进行配置

Hexo Volantis 主题使用

请参考 hexo-theme-volantis/_config.yml 进行配置

Hexo Ayer 主题使用

请参考 hexo-theme-ayer/_config.yml 进行配置

Hexo NexT 主题使用

暂不支持 NexT 8 以下的版本,请先升级到 NexT 8。然后在 Hexo 项目根目录执行

sh
# For NexT version >= 8.0.0 && < 8.4.0
npm install hexo-next-twikoo@1.0.0
# For NexT version >= 8.4.0
npm install hexo-next-twikoo@1.0.3

然后在配置中添加

yml
twikoo:
  enable: true
  visitor: true
  envId: xxxxxxxxxxxxxxx # 腾讯云环境填 envId;Vercel 环境填地址(https://xxx.vercel.app)
  # region: ap-guangzhou # 环境地域,默认为 ap-shanghai,腾讯云环境填 ap-shanghai 或 ap-guangzhou;Vercel 环境不填

Hexo Matery 主题使用

请参考 hexo-theme-matery/_config.yml 进行配置

Hexo Icarus 主题使用

请参考 基于腾讯云,给你的 Icarus 博客配上 Twikoo 评论系统 by 异次元de机智君💯

Hexo MengD(萌典) 主题使用

请参考 hexo-theme-MengD/_config.yml 进行配置

hexo-theme-fluid 主题使用

请参考 配置指南-评论 进行配置

hexo-theme-cards 主题使用

请参考 hexo-theme-cards/_config.yml 进行配置

maupassant-hexo 主题使用

请参考 maupassant-hexo/_config.yml 进行配置

hexo-theme-redefine 主题使用

请参考 Redefine 官方文档 #comment 进行配置

Hexo-Theme-Solitude 主题使用

请参考 Solitude 文档 进行配置

在 Hugo 中使用

hugo-theme-stack 主题使用

请参考 Comments | Stackhugo-theme-stack/config.yaml#L83 进行配置

FixIt 主题使用

请参考 入门篇 - FixIt #主题配置hugo-fixit/FixIt/config.toml#L613-L624 进行配置

在 VitePress 中使用

请参考 VitePress 集成 twikoo 参考解决方案 进行配置。

通过 CDN 引入

提示

如果您使用的博客主题不支持 Twikoo,并且您不知道如何引入 Twikoo,您可以在 Github 提交适配请求

html
<div id="tcomment"></div>
<script src="https://cdn.jsdelivr.net/npm/twikoo@1.6.38/dist/twikoo.all.min.js" integrity="sha384-4KfOjEinLSkv1i1J8TzlkC/RTnuiLoR1OLerVgjEKoH5djYtbf7mzEFsz9p3nfuA" crossorigin="anonymous"></script>
<script>
twikoo.init({
  envId: '您的环境id', // 腾讯云环境填 envId;Vercel 环境填地址(https://xxx.vercel.app)
  el: '#tcomment', // 容器元素
  // region: 'ap-guangzhou', // 环境地域,默认为 ap-shanghai,腾讯云环境填 ap-shanghai 或 ap-guangzhou;Vercel 环境不填
  // path: location.pathname, // 用于区分不同文章的自定义 js 路径,如果您的文章路径不是 location.pathname,需传此参数
  // lang: 'zh-CN', // 用于手动设定评论区语言,支持的语言列表 https://github.com/twikoojs/twikoo/blob/main/src/client/utils/i18n/index.js
})
</script>

建议使用 CDN 引入 Twikoo 的用户在链接地址上锁定版本,以免将来 Twikoo 升级时受到非兼容性更新的影响。

更换 CDN 镜像

如果遇到默认 CDN 加载速度缓慢,可更换其他 CDN 镜像。以下为可供选择的公共 CDN,其中一些 CDN 可能需要数天时间同步最新版本:

  • https://s4.zstatic.net/ajax/libs/twikoo/1.6.38/twikoo.all.min.js
  • https://lib.baomitu.com/twikoo/1.6.38/twikoo.all.min.js
  • https://cdn.jsdelivr.net/npm/twikoo@1.6.38/dist/twikoo.all.min.js

建议使用 CDN 引入 Twikoo 的用户参考上一段的示例在代码中加入 SRI 属性以确保完整性。

开启管理面板(腾讯云环境)

  1. 进入环境-登录授权,点击“自定义登录”右边的“私钥下载”,下载私钥文件
  2. 用文本编辑器打开私钥文件,复制全部内容
  3. 点击评论窗口的“小齿轮”图标,粘贴私钥文件内容,并设置管理员密码

配置好登录私钥之后无需留存私钥文件,请勿再次下载登录私钥,否则会导致之前配置的登录私钥失效。

开启管理面板(非腾讯云环境)

点击评论窗口的“小齿轮”图标,设置管理员密码

Released under the MIT License.