从 shoka 迁移

重新安装主题

先卸载hexo-renderer-multi-markdown-it 随后运行 SXC 安装主题

npm

# hexo init
npm install shokax-cli --location=global
# cd your_blog
SXC install shokaX

pnpm

# hexo init
pnpm add shokax-cli --location=global
# cd your_blog
SXC install shokaX

配置修改

首先，建议使用_config.shokaX.yml而非直接修改主题_config.yml
这样可以防止因缺少配置导致的生成报错

seo 类

原先的搜索引擎验证已迁移为如下配置：

seo: # 下方直接填入对应meta的content即可
  bing:
  google:
  yandex:
  baidu:

百度统计迁移为如下：

visitor:
  baiduAnalytics: # 百度统计代码中的?后部分

评论系统

shokaX 不再支持 minivaline 评论系统，建议迁移到waline

twikoo 等评论系统也提供了迁移工具，可以自行选择

基础配置

# assets代替了之前的image选项
assets: "assets"

ShokaX 提供了官方的 ICP 及网安备案配置：

footer:
  icp: # ICP备案
  enable: false
  icon: "beian.webp" #网安备案图片
  icpnumber: "xxx" # ICP备案号
  beian: "xxx" # 网安备案号
  recordcode: "xxx" # 网安备案链接中的recordcode参数

其他修改

技术修改

ShokaX 将模板从 njk 更改为了 pug，这可能会对具有大量魔改的 shoka 站点迁移产生困扰。

同时，ShokaX 的 page js 部分使用了 typescript。所以在修改代码后请自行编译，否则改动不会生效。

页面修改

ShokaX 不会自动生成404.html，需要在 source 目录下手动放置 404.md 以生成 404 页面