Home 胡搅蛮缠 逼逼叨叨777777 主题文档

跳票 N 久终于更新的简单的使用说明

  • hexo-theme-shoka ：本博客自用的主题
  • hexo-renderer-multi-markdown-it：配套的 markdown 渲染器

已经支持 hexo 5。

因博主被学业和工作掏空，本项目已停滞更新大半年，问题也无法及时回复大家，这个悲惨状态可能还要持续半年的样子。

有很多热心小伙伴在评论区或者项目 issue 帮忙回答问题，非常非常感谢！

本项目是完全开源的，也有做一些 example 示例，大家可以随便拿随便改。
但是很抱歉，博主我暂时不能提供更多的支持，这个写的乱七八糟的文档，暂时也没有时间把它写得更专业一些。
非常对不住大家！

iconfont 的添加申请，我看到留言后会尽快加上，希望各位小伙伴能看到。

当前版本更新至 0.2.5，更新记录点此

🚀快速开始 - 💌依赖插件 - 📌基本配置 - 🌈界面显示 - 🦄特殊功能

# 设计缘由

前几年在 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

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

🔧 修复一些 BUG

# 0.2.3 👉 0.2.4

⚠️ 评论功能更新

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

⚠️ 配置新增

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

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

⚠️ 增加 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 等
🔧 一些显示问题