我是基于ChatGPT-turbo-3.5实现的AI助手，在此网站上负责整理和概括文章
本文详细介绍了如何使用Hexo、ShokaX主题以及Vercel/Github Pages搭建个人博客的过程，特别是评论系统和搜索功能的配置。首先，文章提醒读者在配置中妥善管理关键密钥，以避免泄露和不必要的费用。接着，介绍了两种评论系统的配置方法：Waline和Twikoo，强调需要独立部署后端。对于Waline，提供了在LeanCloud创建应用和在Vercel部署后端的步骤，并指导如何在博客配置文件中添加相关设置。对于搜索功能，建议使用Algolia，并详细讲解了如何创建应用和索引，最后提醒用户在博客部署前执行索引上传命令。整体上，文章为搭建个人博客提供了实用的配置指导。
本文会涉及到一些关键密钥，请在配置过程中妥善管理，避免泄露，从而影响使用或产生不必要的费用
因为本文是记录博主的搭建过程，所以对于我没有选择的方案不会细说其实是因为懒，这也是为什么说自己是记录贴
到这里应该就是本文的最后一部分了，如果有下一篇的话，应该是和主题美化相关的
但是我现在也在摸索阶段，感觉能说的内容比较少，故先不更新
不过可以插个眼，我攒足内容之后会接着更新
# 评论系统
shokax 内置两套评论系统，分别为 waline 和 twikoo，都需要独立部署后端，故使用 github pages 部署的无法使用。
可以自行修改代码替换 valine/minivaline，shokax 不提供支持，需要自行更新维护。
# Waline 配置
# LeanCloud 设置
waline 评论系统需求的数据库，评论数据都存在这里面，必须配置
首先，登陆 / 注册 LeanCloud，记得看一眼左上角，换成国际版
完成之后打开控制台，点击 创建应用 ，名字随意，大致能看出来是干什么的就行
创建好之后，左边 设置 → 应用凭证 ，上面三个就是之后要用的，到这里第一步结束了
# Vercel 部署后端
按一下这个按钮，会自动带你到 vercel 的 waline 部署界面这个功能真省心（￣︶￣）↗
貌似由于渲染问题，按钮点不了（；´д｀）ゞ，那将军只能走此小道了👉点这里跳转👈
项目名随意，vercel 会自动给你建一个仓库，仓库名和你输的这个项目名一样，注意命名格式，不通过就按照框框里这种来
完成之后点击 Create ，等待 vercel 自动部署，部署完成之后点击 Go to Dashboard 去到控制台
然后上面导航栏 Settings → Environment Variables ，来到这个页面
在框框里添加环境变量，就是 LeanCloud 里那三个，对应规则参考下面
| Key | Value |
|---|---|
| LEAN_ID | AppID |
| LEAN_KEY | AppKey |
| LEAN_MASTER_KEY | MasterKey |
完事之后，点击 Save 保存，需要重新部署一下才能生效，一般会自动弹窗让你点，如果没有的话
导航栏 Deployments → Redeploy
之后绑定一下你的域名就可以了，不然用不了，原因前面说过
怎么绑定可以参考第二篇自定义域名中给 vercel 项目绑定自定义域名的操作，记得起个有辨识度的二级域名
# ShokaX Waline 配置
来到我们的博客根目录，找到 _config.shokax.yml ，如果你是跟着我安装的主题，这里应该有，没有可以去主题目录里改 _config.yml
加入下面的配置，把 serverURL: "" 改成 serverURL: "你的waline后端域名"
建议去主题目录 (thems/shokax) 把 _config.yml 内容全部复制过来，不然下次要改其他的还得去找过来添加
waline: | |
enable: true # 是否启用 | |
serverURL: "" # waline 服务端地址 | |
lang: "zh-CN" # 评论界面语言 | |
locale: {} # 本地化替换，详见 waline 文档 | |
emoji: # 表情包，默认为 waline 官方配置 | |
- https://unpkg.com/@waline/emojis@1.0.1/weibo | |
- https://unpkg.com/@waline/emojis@1.0.1/alus | |
- https://unpkg.com/@waline/emojis@1.0.1/bilibili | |
- https://unpkg.com/@waline/emojis@1.0.1/qq | |
- https://unpkg.com/@waline/emojis@1.0.1/tieba | |
- https://unpkg.com/@waline/emojis@1.0.1/tw-emoji | |
meta: # 评论可以填写的项目 | |
- nick | |
- mail | |
- link | |
requiredMeta: # 评论必须填写的项目 | |
- nick | |
- mail | |
wordLimit: 0 # 评论字数上限 (不建议为 0) | |
pageSize: 10 # 每页显示评论条数 | |
pageview: true # 页面浏览量显示 |
到这里 Waline 就完成配置了
# Twikoo 配置
如何部署 Twikoo 评论系统后端请移步→Twikoo 文档
也可以看看下面的视频
# ShokaX Twikoo 配置
来到我们的博客根目录，找到 _config.shokax.yml ，加入下面的配置
twikoo: | |
enable: true # 是否开启 | |
mode: vercel # vercel (私有部署) 或 tencent | |
envId: "https://example.com" # twikoo 环境 ID,vercel 和私有部署填地址 | |
region: # vercel 和私有部署不填，腾讯云见 twikoo 文档 |
# 搜索功能
第一步，先去 Algolia 官网，注册一个账号，建议使用 Github 账号来注册，有了也可以直接登陆
做完后，左侧导航栏找到 Search
如果是第一次使用 algolia，需要先创建一个 Application，应该是在上面，因为我已经注册过了，不知道第一次来的时候是不是在这里，没有就多找找
创建好之后，就在旁边，点击 + Create Index 创建一个 Index ，名字随意，但建议要有辨识度
然后还是左侧导航栏， Settings → API Keys
然后按照下面的对应关系
| 配置 | 页面数据 |
|---|---|
| appId | Application ID |
| apiKey | Search API Key |
| adminApiKey | Admin API Key |
| indexName | 你之前创建的 Index 名称 |
把下面的配置修改好后加到博客根目录 _config.yml 的末尾，到此就大功告成了
algolia: | |
appId: #Your appId | |
apiKey: #Your apiKey | |
adminApiKey: #Your adminApiKey | |
chunkSize: 5000 | |
indexName: #"shokaX" | |
fields: | |
- title #必须配置 | |
- path #必须配置 | |
- categories #推荐配置 | |
- content:strip:truncate,0,2000 | |
- gallery | |
- photos | |
- tags |
不要忘记在博客部署前命令行执行 hexo algolia 上传索引，不然搜不到东西
