关于本站

这是一个业余时间磕磕碰碰搭建起来的网站。

本文前半部分介绍实现方案和工作流程，后半部分讲我为什么把搭博客这么简单事情搞那么复杂。

实现方案

TODO

工作流程

写博客的工作分为两类：

编辑 markdown 格式的文本提交到 git 仓库
编辑图片或者其他二进制文件保存到 nextcloud 网盘，插入 markdown 中

在用户（我）编辑完文本后，只需提交代码即可，剩下的步骤通过 Jenkins 启动更新网页的流程。

git 仓库托管在家里的 gitea 服务器上，gitea 收到 merge 代码的操作后会告知 Jenkins，Jenkins 收到请求触发一台树莓派执行 Jeklly 的构建任务。构建完后，把生成的 http 文件用 rsync 同步到 nginx 的目录中。至此自动化流程结束。

其中，Jenkins、nginx 和 frp 在公网的 docker 容器里。 gitea 和 nextcloud 装在了自己一台二手 PC(NUC) 上，Jeklly 装在一台小树莓派上，frp 内网穿透，平时使用 vscode 写博客

这是一个极度冗余的设计：

gitea 服务器上只有我一个用户，一个 blog repository
jenkins 服务器上只有我一个用户
blog repository 只有我一个人提交，只有一个分支
作为 jenkins worker 的树莓派绝大多数时间是空闲的
docker 主机常年 cpu 负载不到 5%，月流量不到 1% （已经是最便宜的套餐了）

关于持续集成是什么，可以参考两篇很好的文章：持续集成是什么？(阮一峰)、 Continuous Integration(Martin Fowler)

关于 Jkelly，Vuepress 等 静态网站生成器 有一个排名网站，可供选择的非常多

关于技术内容就这么多，以下内容是搭建网站的题外话

题外话

对于搭建网站，我不是专业的 web 开发人员，只是兴趣使然。

写这篇博客的时候我在一家芯片 IP 公司工作。职位是软件工程师，有很大一部分时间在搞版本控制和持续集成。

搭这个博客有三大目的：

把博客当成一个工程化的软件项目练手
学学先进地 web 技术
练习写作

过程就是一步一步搭建一个博客网站，给自己制定工作流，逐步给博客添加功能，同时反复修改文章。把内容创作，发布审核，版本控制，数据迁移和备份，自动部署通通都搞起来。

其实，很早就有写这篇博文的念头，在读研究生时，随着项目的发展，越来越多的代码和论文让我手足无措。这很让人烦恼，我就在想：“我得找个工具管理这些混乱的文件”。但是我都没做下去，原因也很简单，持续集成这种事情往往是解决问题的配套设施，而不是问题的关键。

当时尝试过 git，可惜完全玩不转。我读的是电路与系统专业，并没有接触过“偏软件”的工程管理模式，甚至连自动化测试是什么都不知道。我会花大量的时间使用 Verilog, Matlab, C 和 labview，在 Windows 系统上编程。当时也能完成项目，现在想起来，因为流程的不严谨，很多实验都是低效甚至有瑕疵的。当然，工作还是能完成，只能说项目的代码量和修改量还是太小了。自己掂量了一下，版本管理不是问题的关键, 我就没再花时间去优化流程和整理文档。

工作后，学习了持续集成的相关方法，我决定在业余时间实践一下。

现在我准备搭建一个博客了，这个事情我打算要长期坚持。所以我准备在这小小的事情上解决一下之前在写论文、写代码上遇到的问题。

我做了一个类比，把需求和问题列在一起：其实工作了之后，在知道软件工程里这都有很好的工具解决这些小问题：

好消息是解决每个问题都有很多方法和工具可以用，坏消息是要开始技术选型了。回归写博客这个话题。首先博客实例放哪？

博客平台
网站托管
自建网站

首先排除博客平台和网站托管，我们选择最折腾的自建网站。

两个月后……（从租服务器，选网址，到认证审核，再熟悉服务器的操作，差不多搞了一个多月）

服务器的问题做好了，首先就学点 Html 写个 Hello World ，然后改变个背景色，成就感满满。当我正准备写第一篇博文的时候。我就写不下去了，体验太差了！既要写文章还要同时考虑排版。虽然这两件事情单独分开做我还是乐意。但混在一起做我觉得不够优雅。同时也开始考虑我应该用什么载体写我的文章：

LaTeX
- 在写论文的时候尝试过一点点，文字和排版独立操作的编辑方法是我想要的，但是如何转化为易于在线浏览的网页博文，似乎没有很好的解决方案。总不至于把博客搞成论文下载网站吧。(点击标题下载最新版PDF :D）
office Word
- 功能足够强大，从小就开始用。虽然所见即所得使用起来方便，但是版本控制不方便，我无法在同一个文件里切换多个版本，无法查看历史版本的变动记录。当然还有 license 的问题。
印象笔记
- 用了一段时间，花里胡哨。但支持各种格式转换很有意思，markdown 的支持做的不错。
动态博客软件 WordPress
- 用了几个月。写作体验是很不错的，功能非常多，插件系统厉害到可以做出任何网站。我甚至花了点时间学习制作插件，只是觉得技术太老，自学还是学点新的，最后入 laravel 的坑。让我放弃WordPress 的原因还是内容的管理方式。动态博客有很多功能，例如在线编辑、评论、开放API等。但这些都是建立在数据库技术之上，博文的内容当然也是在 mysql 的表里。所有的操作也会避免直接操作数据库。对内容的版本控制事实上是对数据库的版本控制。我找不到能和 git 一样控制一个 txt 版本一样方便的工具来控制 WordPress 博文的方法。几个月后，我把 WordPress 的博客关了。
静态博客软件 hugo vuepress jekyll ...
- 正在使用

关掉 WordPress 之后我重新梳理了一些自己对写博客的需求，一些我想要的：

与其在浏览器里编辑我的博客，我更喜欢直接在编辑器（word，vim，vscode）里写作
我想要知道每次的删改的内容，但不需要知道读者
我希望排版独立于内容：写作时专心内容，排版时专心编程。二者文件不能相互污染

另一些功能是我不想要的：

强大的多媒体功能：我没有特别多的照片和视频想要分享
社交系统：我只想留email
花里胡哨的主题

挑来选去只剩 hugo, vuepress 和 Jeklly 这类静态网站生成工具能满足我的需求了。一开始随便选了个 vuepress，用了半年发现自己花了太多时间在琢磨 vue 的插件怎么玩，又从 vuepress 迁移到了 Jeklly。

最后就是 CI 了，工作中用的是 Jenkins，这次花了点时间学 Drone。部署起 node 项目还是足够应付的。用了几周之后发现对非 Docker 的项目不是很友好，又用回了 Jenkins。

所有的软件都准备好后，我终于可以开开心心地用 markdown 来写博客，专注于写作内容了。而且重要数据全在 git 里，每台电脑里都有副本，很安心。更新博客的时候自己给自己装模做样地审稿，审阅通过了自动更新到网站，流程很顺畅。

就这样下班在家的时候折腾折腾，终于有了第一章的实现方案。写完这篇博文，已经是租服务器第二年的事情了。