preface

之前使用aliyun服务器以及b3log/solo搭建个人博客，感觉维护上较为困难，且需要维持一个不常用的云服务器，因此萌生了使用其他方法搭建博客的主意

我个人对博客的要求较为简单，支持丰富的Markdown语法即可，因此Hexo+Github Pages的方法引起了我的兴趣，这篇文章就是对搭建过程一个简单的总结，方便个人日后维护

准备工作

安装node.js，git等必备工具

搭建

参考开始使用

Markdown语法支持问题

个人对markdown的一个重点要求就是必须支持LaTeX数学公式的渲染，因为工科背景，写东西时引用一些公式也算正常情况

但是hexo默认的渲染器hexo-renderer-marked不支持该功能，因此考虑使用markdown-it系列插件替换之

首先卸载默认渲染器插件：

> yarn remove hexo-renderer-marked

然后安装新的渲染器hexo-renderer-markdown-it，看名字也知道它集成了markdown-it：

> yarn add hexo-renderer-markdown-it

接着，安装markdown-it的相关功能插件，这里选择的是markdown-it-mathjax；虽然KaTeX性能优于MathJax，但是markdown-it-katex中自带的KaTeX版本过低，生成的index.html经常有错位问题：

> yarn add markdown-it-mathjax

最后在_config.yml中按照wiki of hexo-renderer-markdown-it中的示例，添加配置文件即可获得LaTeX公式的渲染支持

值得一提的是，必须修改主题中相应的配置，才可获得最终的显示效果。以next主题为例，按照这里的examples设置后方可看到渲染好的数学公式

deployer

即部署工具，既然要部署到github上去，自然少不得hexo-deployer-git:

> yarn add hexo-deployer-git

然后修改_config.yml中相应内容如下：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: the url of your repo, support url based on ssh!

完成后就可以一键部署啦！

End

至此，Hexo静态博客的搭建就告一段落，后续的美化之类的操作应当单独开新文章叙述