挑静态博客框架期间,对比看过 Hexo、Hugo 等主流方案,最后定了 Docusaurus,主要是刚好满足了几个需求:偶尔写点技术内容、想把博客和文档放在一起、又不打算为了样式从头写 CSS,积累的经验也可以复用至工作中的技术文档项目。
从 Fork 模板开始,到改成现在这个样子,前后断断续续一两周。这篇文章把整个过程整理一遍,省得自己以后忘了,也给打算自己搭一个的朋友做个参考。完整代码在这里:heywalter/FlowingDocs,欢迎 Fork 或 Clone 直接复用,然后按照本文的步骤把站点信息和外部服务凭证换成自己的就能跑起来。