golang 使用模板新增文件_使用mkdocs搭建博客和编写文档

平时比较懒，写的文章和羊拉屎一样，东一点，西一点，散落在各个平台。一直想把所有的文章都放在一个统一的地方，可以起到备份作用，同时也希望有一个自己的窝。

以前也尝试用过 hexo 和 Hugo 这样的静态博客，搭配上主题还是非常舒服的。不过功能上偏向博客需求，如果想定制一些专题写作计划，实现起来比较麻烦。

经过一番折腾，决定把文章签到到文档生成器上，看起来会系统一些，当然也会存在一些问题，比如标签管理和编写时间的缺失。任何计划都有利有弊，还是先做一个出来再说。

选择 mkdocs 还是 sphinx

因为自己主要使用 python 语言，所以还是使用 python 开发的工具会比较有安全感，如果真遇到问题，至少可以通过源码去排查问题。python 其实也有 pelican 这样的静态博客生成器，使用起来也非常方便。在文档生成器上，主要有 2 个主流的：mkdocs 和 sphinx。

很多大佬写的框架都是 sphinx 编写的，比如 requests 库就是通过 sphinx 部署在 readthedocs 平台上。

mkdocs 用来会简单一些，而且越来越多的新框架使