hexo 折腾小记

hexo 是一套静态网页生成框架
类似的还有 Jekyll ^{GitHub 默认推荐的框架} / Hugo (🤔 WordPress跟它们算同一类么?)
这里 也有人做了三者的优缺点分析

安装

npm, cnpm, yarn, pnpm 之争( 槽点① )

hexo 本身使用 npm 安装
但是安装 hexo-deployer-git 时死活装不上
网上搜了下, 后来使用 cnpm 完成了安装(好像还使用了 registry 参数? 隔了几天记不太清了...)
然后之后应用主题, 调整插件时, 各种组件、手册里又引入 yarn，pnpm
安装，使用时生成的各类关于包管理、依赖的报错, 对于平时不怎么接触这些的人来说，简直噩梦

主题

shoka

作者的博客
照着他手册说的来, 基本能配置个大差不差 ^{除了自定义图片, 据说是渣浪的原因, 没法正常显示了}
作者自己的博客开启了一个离开再返回会显示一遍载入, 挺耗时的...

自定义

首先是可以编辑 _config.shoka.yml 文件(没找到? 把主题根目录下的 _config.yml 复制到博客的根目录并命名为前面的即可)
其次你对页面的一些 css 不满意的话, 那就要去 THEME_dir\source\css 下面修改 .styl 格式的配置文件了

使用感觉

其实可自定义的项目还不是很灵活, 比如:

• BGM 只支持 网易云/QQ/虾米^{什么?!虾米还活着吗}
• 站内搜索使用的是 AlgoliaSearch, 这个需要注册账号并调用 API 的, 其实如果可以, 添加hexo的 localSearch 也不是不可以 ^{查阅资料时发现有人已经做过实现, 不过代码适配的hexo版本有点旧了}
• 其它 - 等我再用用

💩 衍生主题 shokaX ( 槽点② )

项目所有人称之为 “shoka的一个二次开发版(算精神续作)”
但是今天尝试应用, 碰了一鼻子的灰...
吐槽一下

• 别人主题都是 git clone 直接拉库, 怎么到你这还要搞个 npm module ?
• 安装模块默认使用 yarn 进行依赖安装, 可以使用 -pm 参数来指定其它包管理工具, 但是我手册就是不写 ^{让使用者猜是吧?}
• 使用 yarn 默认模块安装一堆报错, 手册里却又建议不要手动安装 ^{不建议手动, 那你倒是把自动做做好, 把文档写完整呐...}
• 安装主题所使用的 module , 只有 install 命令, 没有 uninstall/remove 命令 ^{nm管杀不管埋?!}

够够的了, 本来是搞 shoka 的本地搜索才看到这个主题, 心想着它自称 “修复了一堆shoka留下的bug” 来试试
没想到安装就比 shoka 麻烦这么多, 👋

💩 shokaX - 补充

翻看shoka作者博客时, 看到 疑似二次开发者 在评论区“热心”回答网友的疑问 并附上自己主题的链接 供网友处理问题