# 设计缘由

前几年在Bear和Evernote上整理了大量笔记，非常喜欢Bear默认的markdown渲染样式。
后来因为换了安卓手机，用不了Bear，四处搜寻替代品，没有满意的。
然后阴差阳错知道了Hexo，又得知Github也可以免费建私有仓库了，故再次转移阵地到了自建博客，并部署在Github Pages。

因为这个博客是用来记笔记的，故起名书架。
对应的主题即Theme.Shoka，可以说是为了笔记阅读而生的主题。
样式严重参考Bear，部分代码严重参考NexT。

Hexo的默认及常用渲染器均使用highlight.js进行代码高亮，而我喜欢Prism.js，故重写了一个渲染器配合主题食用。
渲染器取名multi，因为集成了很多很多很多markdown-it插件，以及压缩静态文件的功能。
（最新版的默认渲染器也支持Prism.js了，可喜可贺，但不想用，哈哈哈哈哈哈哈

墙内Github Pages访问速度时而感人，所以用了jsDelivr加速，主要是因为它可以按需合并依赖文件。

# 快速安装

# 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等
🔧 一些显示问题