# 快速安装

# cd your-blog

git clone https://github.com/amehime/hexo-theme-shoka.git ./themes/shoka

打开主题目录，内有 example 文件夹，提供了配置文件的 demo 供参考。

# 安装依赖插件

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

插件安装与配置教程戳此

# 应用主题

# 修改站点配置

修改站点配置文件 <root>/_config.yml ，把主题改为 shoka

theme: shoka

# 修改主题配置

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

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

主题的基础配置可以参考这里
界面显示相关的配置参考这里

# 更新记录

标签含义：
❗ 需要手动操作的更新信息
⚠️ 需要注意的更新信息
🔧 已修复的问题
⌛ TODO

# 0.2.4 👉 0.2.5

💡 避免直接修改主题文件，添加各种自定义：

• 样式：包括配色、icon、其他自定义样式
• 图片：包括主题图片、随机图库

🔧 修复一些 BUG

# 0.2.3 👉 0.2.4

⚠️ 评论功能更新

• MiniValine 魔改版更新至 beta10，修改过主题默认 _config.yml 的同学，记得更新末尾的 vendors 到最新哦
• ❗ 评论相关的配置有更新，配置戳此
  • 主要增加的 Tag 配置，现在可以各种自定义啦

⚠️ 配置新增

• 夜间模式 darkmode ，配置戳此
• 自动定位 auto_scroll ，配置戳此
• 图床 API 设置 image_server ，配置戳此

⚠️ 背景音乐功能增强，配置戳此

• 可以添加多个播放列表
• 加了一些控制按钮

⚠️ 增加 media 标签，在文章中插入音频和视频播放列表，方法戳此
⌛ 视频播放器有待增强（显示分段标签，字幕）

🔧 随机图库支持非渣浪图床的任意图片
🔧 还有许多小 BUG

# 0.2.2 👉 0.2.3

❗ 增加主题文件外自定义语言包的功能，配置戳此
🔧 提高低版本浏览器兼容性

# 0.2.1 👉 0.2.2

⚠️ 弃用 mediumzoom ，改成 fancybox ，配置戳此
💡 增加语言包： 繁体中文 和 日语
💡 quiz 功能优化，根据语言显示题型标签
🔧 修复评论功能中反复初始化 leancloud-storage
🔧 修复 audio: false 时不能隐藏播放按钮、停止播放

# 0.2 👉 0.2.1

⚠️ 配置文件添加 loader 参数，配置戳此
💡 二级 list 区别显示
🔧 修复浏览位置定位 BUG
🔧 修复 firework 动画延迟
🔧 优化评论功能

# 0.1.9 👉 0.2

⚠️ 评论功能大改

• 弃用不开源的 Valine，改用 MiniValine，并且进行了魔改，项目戳此
  主要是大量压缩了代码，弃用一些花里胡哨的功能，又加了一些别的花里胡哨的功能。
• 为防止泄露用户邮箱、IP 等隐私信息，弃用 QQ 号获取昵称及头像。
  ❗ 同时需要手动进行一些迁移，具体步骤戳此
• ❗ 评论相关的配置亦有更新，配置戳此

⚠️ 增加单击页面烟花效果，配置戳此
💡 弃用 Velocity，改用 anime.js，方便未来添加更多花里胡哨的功能严重拖慢页面滑行速度
🔧 新增多枚 icon，包括豆瓣 i-douban 等
🔧 一些显示问题