插件名称	npm 地址	功能	依赖程度
hexo-renderer-multi-markdown-it	链接	md 文件渲染器，压缩 css/js/html	必需
hexo-autoprefixer	链接	给生成的 css 文件们添加浏览器前缀	必需
hexo-algoliasearch	链接	站内搜索功能	搜索按钮失灵
hexo-symbols-count-time	链接	文章或站点字数及阅读时间统计	统计没有
hexo-feed	链接	生成 Feed 文件	Feed 文件没有

没有正确安装以上插件的话，主题会报错 or 无法正确显示 or 部分功能失效。

在应用主题之前，必须至少安装 hexo-renderer-multi-markdown-it 渲染插件和 hexo-autoprefixer。

详细可阅读这篇 shoka 的依赖插件文档： Step.1 依赖插件

# multi-markdown-it 安装与配置

npm un hexo-renderer-marked --save

npm i hexo-renderer-multi-markdown-it --save

	markdown:
	render: # 渲染器设置
	html: false # 过滤 HTML 标签
	xhtmlOut: true # 使用 '/' 来闭合单标签（比如 <br />）。
	breaks: true # 转换段落里的 '\n' 到 <br>。
	linkify: true # 将类似 URL 的文本自动转换为链接。
	typographer:
	quotes: '“”‘’'
	plugins: # markdown-it 插件设置
	- plugin:
	name: markdown-it-toc-and-anchor
	enable: true
	options: # 文章目录以及锚点应用的 class 名称，shoka 主题必须设置成这样
	tocClassName: 'toc'
	anchorClassName: 'anchor'
	- plugin:
	name: markdown-it-multimd-table
	enable: true
	options:
	multiline: true
	rowspan: true
	headerless: true
	- plugin:
	name: ./markdown-it-furigana
	enable: true
	options:
	fallbackParens: "()"
	- plugin:
	name: ./markdown-it-spoiler
	enable: true
	options:
	title: "你知道得太多了"

停用默认代码高亮功能，否则代码块的 mac 样式不能正常显示，使用 Ctrl+F 找到 highlight 和 prismjs ，把 enable 改成 false 。

# hexo-autoprefixer 安装与配置

npm install hexo-algoliasearch --save

缺少这个插件，首页卡片翻转效果在部分浏览器中无法正确显示。

theme: shoka

主题配置的所有参数在 <root>/themes/shoka/_config.yml 文件中。

为了方便主题升级，可以在根目录新建一个 yml 文件，命名为 _config.shoka.yml 。也就是说，所有主题的自定义配置均保存于 <root>/_config.shoka.yml 文件。

hexo clean && hexo g && hexo s

Hexo 博客主题更换完成，在浏览器地址栏输入 http://localhost:4000/ 访问本地部署的 hexo 项目，可以发现主题更换成功了～🎉