hexo博客的一些坑和技巧写在这里。而对于常规操作可以看官方文档。
使用pandoc作为markdown渲染引擎
默认的 hexo-renderer-marked 与 mathjax 和 katex 有很多冲突的问题,所以建议换用 hexo-renderer-pandoc。
确保你已经安装了 pandoc 。然后npm安装即可。 有些主题可能会有js代码检查依赖,把对 hexo-renderer-marked 的检查去掉即可。1
2npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-pandoc --save
使用自定义域名
- 在github项目的 settings 中设置 custom domain
- 为域名设置DNS,设置以下A记录:
- 185.199.108.153
- 185.199.109.153
- 185.199.110.153
- 185.199.111.153
- 设置CNAME记录,www.YOURDOMAIN.com 指向 xxx.github.io
- 在source目录下添加文件CNAME,一行一个写下 www.YOURDOMAIN.com 和 YOURDOMAIN.com
自动部署与持续集成
Github提供了永久域名xxx.github.io使得博客能被永久访问,考虑到没有必要使这个永久域名失效,所以决定把博客部署到自己服务器上,使用自己的域名去访问服务器,和Github pages服务区分开来,这样就算我自己的域名失效了,也能通过xxx.github.io域名访问挂在github上的页面。
总体方案是在服务器通过docker部署nginx和drone,每次博客仓库发生更新,drone就会自动把源码拉下来然后复制到nginx的静态目录下。
Comments