起因

因为我习惯使用markdown记录笔记和折腾各种东西所踩的坑,但是时间久了这些md文件分散在不同项目的不同文件夹下,也丢失了记录的初衷,一直有自己部署一个博客的想法,刚好今天刷到了一个基于hexo-stellar主题的博客,感觉很好看,遂立马hand-on😊

一些细节

  1. hexo的npm-dependencies中的strip-ansi的版本过高,抛弃了一些旧的用法,导致hexo无法在命令行使用,需要降级

    package.json
    1
    2
    3
    "overrides": {
    "strip-ansi": "6.0.0"
    }
  2. latex公式渲染

    渲染工具:Katex、MathJax。十年前MathJax流行度较高,目前Katex更流行。经测试MathJax对复杂公式的渲染效果有限,故本博客采用Katex渲染公式。

    stellar主题使用文档中对于Katex的介绍过于简略,可用的详细的配置方法参考Blog-如何配置Katex公式渲染

    特别需要注意

    _config.stellar.yml中katex的外层还有一层plugins,否则配置不会生效

    此外,katex.min.css的SHA校验存在问题,具体表现为console中报错和公式被渲染两次,解决方式参见issue

    配置完毕之后,公式也应遵循markdown的语法规范,使用$$将公式包裹,否则直接插入的latex公式无法被正确渲染。

  3. 正确配置404页面

    404页面是hexo generate之后就有的,本地服务时默认看不到这个页面,上线后即可正常访问,无需额外配置

参考链接