起因
因为我习惯使用markdown记录笔记和折腾各种东西所踩的坑,但是时间久了这些md文件分散在不同项目的不同文件夹下,也丢失了记录的初衷,一直有自己部署一个博客的想法,刚好今天刷到了一个基于hexo-stellar主题的博客,感觉很好看,遂立马hand-on😊
一些细节
-
hexo的
npm-dependencies中的strip-ansi的版本过高,抛弃了一些旧的用法,导致hexo无法在命令行使用,需要降级package.json 1
2
3"overrides": {
"strip-ansi": "6.0.0"
} -
latex公式渲染
渲染工具:Katex、MathJax。十年前MathJax流行度较高,目前Katex更流行。经测试MathJax对复杂公式的渲染效果有限,故本博客采用Katex渲染公式。
stellar主题使用文档中对于Katex的介绍过于简略,可用的详细的配置方法参考Blog-如何配置Katex公式渲染
特别需要注意_config.stellar.yml中katex的外层还有一层plugins,否则配置不会生效
此外,
katex.min.css的SHA校验存在问题,具体表现为console中报错和公式被渲染两次,解决方式参见issue配置完毕之后,公式也应遵循markdown的语法规范,使用$$将公式包裹,否则直接插入的latex公式无法被正确渲染。
-
正确配置404页面
404页面是hexo generate之后就有的,本地服务时默认看不到这个页面,上线后即可正常访问,无需额外配置