好些年前，就想搭建一个属于自己的博客，网上都是教程——新的旧的，不知道有多少坑等着我去踩，就一直拖着，直到协会“开发组 #-0x01 博客”，才正式提上日程。在RX师傅详尽的教程和BB师傅一对一指导下，一个上午的时间，博客雏形就大致出来了。这里，我就简单记录一下Mac系统下的搭建过程（和Linux没什么差），一来练习Markdown语法，二来提炼要点，方便以后博客崩了好及时恢复，就当作自己的学习笔记啦～

前期准备工作

Git、Node.js、GitHub

首先，需要先下载一个Git和Node.js,以及注册一个GitHub账号，然后终端输入：

1
2
3
$ cd Document/ ##我是创建在文稿
$ mkdir My\ Blog ##转义空格
$ cd My\ Blog/ ##进入这个目录

现在在该目录下，配置之前我们注册好的GitHub账号：

1
2
$ git config --global user.name "你的GitHub用户名"
$ git config --global user.email "你的GitHub注册邮箱"

P.S.后面要有” “，框住你的用户名和邮箱，用户名不是昵称(昵称是用户名上面字体较大的)

SSH Key

学习到为了避免每次使用都要输入密码登录，我们可以配置一个叫SSH Key的玩意儿：

1
$ ssh-keygen -t rsa -C "你的GitHub注册邮箱"

接下来会让你输入各种信息，啥都不用输，无脑回车就是；然后找到生成的.ssh的文件夹中的id_rsa.pub密钥，将内容全部复制下来，打开GitHub_Settings_keys页面，新建一个new SSH Key，Title随便写，把刚刚复制的id_rsa.pub内容粘贴到下面的Key里面，点击Add SSH key；回到终端接着输入：

1
$ ssh git@github.com

如果出现Hi XXX! You’ve successfully…,but…就说明配置成功啦!
具体实现原理参考知乎吴润

Hexo

安装

1
$ npm install -g hexo-cli

初始化

安装好Hexo后，终端进入到早先创建好的空文件夹目录下，输入：

1
$ hexo init

一定得是在空文件夹下，不然会报错！当出现一行行华丽的代码之后，博客就基本搭建成功了～不信你看，那个空文件夹下已经出现很多奇奇怪怪的文件。

本地预览

终端输入：

1
2
$ hexo g
$ hexo s

就可以在浏览器打开本地博客，看见刚搭建好的博客雏形～当同时按下“control+C”时，关闭本地预览。

部署到GitHub

我们肯定不会仅局限于本地预览，那还建什么博客？打开GitHub界面，新建一个仓库，命名为你的GitHub用户名.github.io，后面据说加不加用户名都行，保险起见，还是加上吧。
我用的是BBEdit编辑器，是个编辑器能打开文档就行，打开位于My Blog文件夹下的_config.yml，在最下面找到deploy，编辑一下：

1
2
3
4
5
6
## Deployment
### Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

P.S.因为众所周知的BLM运动，branch: 后面跟main，不再是master。

接着，输入如下指令安装相关插件：

1
$ npm install hexo-deployer-git --save

最后，再键入两条命令，我们的博客就成功部署到GitHub上了！浏览器输入你的用户名.github.io，试试看～当写好文章想更新至GitHub上时，也是这两条指令。

1
2
$ hexo clean #清除上次的缓存
$ hexo g -d #等价于执行hexo g后，再执行一次hexo d。

日常使用

要写博客的时候，打开终端，cd到博客文件夹路径下，输入：

1
$ hexo new post "文章名称"

就能新建一篇带有标题的文章～这里推荐一个自用的MarkDown编辑器——MWeb。
全文内容、结构参考自RX博客