如何在一周内建造核心舱

最近这段时间，我萌发了搭建一个技术博客的想法。仅仅用了一周左右的时间，我就搭建好了，并且把它取名为“卡洛的核心舱”。

1 开始

在本学期，我开始逐渐投入到科研项目中。写代码时自然会遇到不少问题，绝大多数都是通过百度搜到他人的CSDN文章和个人博客文章解决了。少数问题我也是通过不断地尝试，自己排除了bug。在这期间，部分十分宝贵的值得留存的解决方案我没有记录下来，十分可惜。

在项目暂告一段落后，我有了相对充足的一段时间，考虑到之前的自媒体平台不适合撰写技术文章，于是在研一的最后一个星期，我开始尝试搭建起技术博客。

目前主流的博客搭建方法有两种。一是WordPress+云服务器的模式，这种方法我尝试过，但是随着我的腾讯云云服务器学生优惠机会所剩无几，而我也可能无法承担起如此高昂的租赁费用；此外它是基于CentOS和PHP开发，对我来说不大友好，有一定的学习成本。

二是利用GitHub的GitHub Pages功能，加上开源的博客框架，做出静态页面即可。我选择尝试这种方法。

在此之前，我参考了很多人的博客，包括本科同学哈哈哥的博客就是基于GitHub Pages搭建。

2 GitHub Pages和git

7月26日，杭州的台风天还没结束，我冒着风雨到达办公室，正式开始搭建之旅。

我最开始试验的是GitHub Pages。之前本科同学得意哥就用这个功能写了课设代码的前端页面。GitHub Pages就是GitHub为用户提供的一个把代码转化为静态页面的一个工具，因此拿它写博客也不在话下。

这里值得一提的是，得益于我半年来做科研项目的过程，我对“用git管理代码”的方式已经非常熟悉，众多的git指令背了又背，pull、push、origin之类的单词已经深入我心。它作为代码管理和版本控制的工具，虽然对于初学者可能劝退，但我却省去了学习的过程，根本不需要翻过第一座大山。

其实我到办公室最开始想尝试的是Gitee Pages（科研项目用的是Gitee，国内的基于git管理代码的网站），但当我建好仓库，传好html时，却发现：

于是我转向GitHub Pages，重复过程搭建仓库后（https://github.com/kaluojushi/gyhnb），得到了我的GitHub Pages页面：

链接是https://kaluojushi.github.io/gyhnb。

这个html虽然简单，除了上面的nb文字外，下面甚至是Lorem ipsum（乱数假文），但这是我4个月前，刚开始学习html时写出的第一个页面。

3 域名

我之前就注册过域名，所以也非常容易地打破了这个我小时候认为的技术壁垒。

为了注册一个合适的域名，我想要先起好博客的名字。很快啊，我想到一个非常极客的名字——“核心舱”，并且在7月28日注册了corecabin.cn。

对于空间站而言，核心舱（Core Cabin）是整个空间站的中枢和管理控制中心。与此类似，我的核心舱主要存储的是与“程序”“技术”“研究”或是“音乐”等一些很酷的东西。

绑定域名非常简单，也不需要域名备案，网上有现成的教程。于是在完成CNAME的上传后，过了10分钟，我就可以通过corecabin.cn而不是kaluojushi.github.io去访问这个仓库的pages了。

4 Hexo

7月29日这天有6场乒乓球赛。这一天，我不仅看完了每一场球赛，还基本完成了“核心舱”的搭建。

以GitHub Pages为基础的博客框架有三种，分别是Jekyll、Hexo和Hugo，其中前两种用得比较多。当我看到Jekyll的全英文文档以及有点复杂的环境配置，我人晕了，于是劝退开始尝试Hexo。

Hexo是台湾人写的，因此有比较详细的中文文档，而且环境配置比较简单，只要Node.js和git即可。

不得不说，再次得益于做科研，这个环境我的电脑上已经有了。

虽然中间出现了'hexo'不是内部或外部命令，也不是可运行的程序或批处理文件。这样愚蠢的错误，但我很快知道这是环境变量的PATH的问题，很快设置好了。hexo的命令也很好记，难度不大，在跟着教程配置一遍后，基本搭建就完成了。

搭建过程中，我觉得Hexo还是很香的，不仅支持本地运行环境，还支持一键部署，并且用到的知识或工具，比如git、npm、Markdown等全是打过很多次交道的很熟悉的东西了，所以我很顺利，没有遇到什么bug。

基础工作既然已经完成，后面的几天里，主要就是做一些完善工作了。

选了个主题maupassant，完成了下相关的配置；
~~部署了hexo-generator-search搜索插件，可以实现文内搜索；~~
~~部署了hexo-wordcount插件，可以显示文章字数与阅读时间，如本文开头所示；~~
部署了Gitalk评论插件，可以用GitHub账号登录留言，如本文文末所示；
基于GitHub Repository、PicGo和jsDelivr搭建了个稳定的图床，本文所有图片均来自图床；
用Markdown写了一部分文章，以及一个Markdown文档。之前我就用Markdown写文档了，所以也不需要一个学习Markdown的过程；
调整了页面很多的细节，补充了一些页面。

5 总结

核心舱搭建成功了，还有些没整完的小细节可以慢慢弄。虽然这个过程中用到的都是我学过的知识，很少碰壁，但是我还是从中收获了很多：

熟悉了~~全球最大同性交友网站~~GitHub，以后会常用；
进一步熟悉了git；
进一步熟悉了npm；
进一步熟悉了环境变量PATH；
进一步熟悉了Markdown；
进一步熟悉了前端知识。

一周时间过去，这一周我除了看看奥运比赛，从学校结束科研回家，也就在全身心投入这个事情了。但我丝毫没觉得时间被浪费，因为把时间投入自己喜欢做的事情，花再多精力也值得，尤其是我从中学习的知识、得到的收获、学会的开源精神和进一步的对代码的热爱，这些不通过自己鼓捣自然是学不到的。

2021.8.13更新

回家后的这段时间里，我也没闲着，继续鼓捣自己的核心舱，这个过程中也发现了众多的bug，并想办法排除了它们。

从主题maupassant换成了主题NexT，作为一个发展时间很长、被全网使用最多的、最为成熟的主题，它集成了很多插件，使得我不需要修改源代码；
修改了一下favicon及其路径，新增了custom-logo，显示在电脑端右上角；
针对NexT主题侧边栏不显示分类与标签，新增了分类与标签页面，便于检索文章；
部署了hexo-symbols-count-time插件显示文章字数与阅读时间，如本文开头所示；
修改了Hexo渲染Markdown的引擎，由hexo-renderer-marked改为hexo-renderer-kramed，以及修改了部分代码，以便对数学公式的渲染达到更好的支持，可以参考这篇文章：《解决hexo-renderer-kramed渲染冲突的部分问题》；
部署了busuanzi插件，用来显示文章阅读次数与网站浏览次数，如本文开头、本站底部所示；
部署了hexo-generator-searchdb插件，可以实现文内搜索，如侧边栏所示；
解决了中文目录不能跳转的bug；
解决了hexo-renderer-kramed不能渲染Todo List的bug，同样可以参考这篇文章：《解决hexo-renderer-kramed渲染冲突的部分问题》；
解决了手机端总是不能访问核心舱的bug，可以参考这篇文章：《解决Hexo博客手机端无法访问的问题》；
通过配置swig文件的方式更新了友情链接的展现形式；
修正了因 Github RSA SSH 策略调整导致的无法部署的问题；
……

以后也可以把更新bug的过程写在这篇文章里。