这里小小汇总了一下搭建 Shoka 主题博客时可能会用到的参考资料，希望能帮到

# Shoka 主题博客补充

# ShokaX 主题

我用排除法发现，如果文章全是精选文章，首页就会无法正常显示

Hexo 主题 Shoka & multi-markdown-it 渲染器使用说明 - Theme Shoka Documentation - 二进制杂谈 - 计算机科学 | Yume Shoka = 有夢書架 = 吾乃天，壶中之天

官方文档 Hexo-theme-ShokaX

# 图床配置

参考博客 ——Shoka 使用自己的图床

在 markdown 中使用 PicGo 没更新到最新版前踩了一个坑：

当端口配置没问题时，却上传不了图片，返回 success：false，可能说明你的 github 的图库中已经存在这个图片了，所以上传失败。

# 首页精选分类

搞了好久都没搞成，最后才发现是映射之间要有一个空格

如：计算机科学 (英文冒号)(空格) 英文名 计算机科学: computer-science

# 站内搜索配置

# 配置流程

• 登录 Algoliaopen in new window 官网，建议使用 Github/Google 账号注册 / 登录。
• 进入 Dashboard - Search - Index 页面，选择上方 + Create Index 创建索引，索引名称建议为 shokaX 。
• 进入 Dashboard - Settings - API Keys 页面，复制如下数据到上方配置中。

• 在博客部署前运行 hexo algolia 上传索引，可在 Dashboard - Search - Index 页面中查看。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

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