我通过阅读 hexo 中文网站 和 相关博客 开始使用 hexo ,并将博客部署到 github pages 。期间遇到的问题是:
Github Pages 不能显示 CSS
网站能够在本地很好地显示,但是到了 github.io 上就不能展示 css 。
一方面需要确认自己的 url 和 root 是否正确,另一方面还可能是包的依赖的问题。如果需要部署的到 github.io 则需要安装 hexo-deployer-git 。
npm install hexo-deployer-git --save
另一方面我还安装了一下依赖库
npm install hexo-renderer-ejs --save
npm install hexo-renderer-stylus --save
npm install hexo-renderer-marked --save
成因是 hexo 无法解析模板文件[1]
Mathjax 无法渲染
另外,可能会遇到 hexo 中 mathjax 公式无法渲染的问题,即使在正常安装了 mathjax 依旧;这个时候需要在 theme 的配置文件 _config.yml
中找到
mathjax:
enable: false
这里将 false
改成 true
就好了。
Reference
[1]. 百度经验