前言

  时隔2年，又一次重新搭建了博客。折腾了大半个月，原本只是想找一份以前写的文章测试一下文章的格式，翻遍了有道笔记，愣是没找到一篇稍微能看的下去的，此时心情之复杂，难以言喻。总之测试还是要做的，就记录一下搭建hexo博客的过程,顺便复习一下markdown语法。
  hexo框架是一位朋友推荐给我的，之前的博客用的也是这个框架，总而言之想要用hexo搭建个人博客的确是非常方便。

安装必要的软件

  • 1.1、安装node.js

​ ​  安装版本推荐12，貌似node.js-v14和hexo有部分内容不兼容，使用的时候会有警告，为了避免后续使用出现问题，还是提早就使用12版本的好，下载地址如下：

​ ​​ ​​ ​node.js历史版本

  • 1.2、安装git

  • 1.3、安装windows powershell(linux用户可直接跳过这一步)

    详细安装过程建议参考以下链接

​ ​​ ​​ ​Windows Terminal 完美配置 PowerShell 7.1

Github配置

  • 2.1、创建托管仓库

​  ​ 新建一个仓库，名字必须设置为 xxx.github.io，其中xxx为github用户名。比如github用户名为clock,那么仓库名称即为clock.github.io，其他名称无法作为博客托管仓库。（这里发现一个彩蛋，如果新建的仓库名为xxx.github时——xxx为用户名，该仓库会作为你的github主页展示）。

  • 2.2、绑定个人域名

​ ​  不打算绑定个人域名or不打算申请个人域名的请直接跳过。

​ ​  首先需要一个域名，可以选择阿里云、腾讯云等等，反正哪里性价比高选哪里。有了域名之后，进入xxx.github.io仓库，点击setting。

​ ​  在GitHub Pages 中设置你自己的域名

​ ​  其中Custom domain 中填入域名，点击save之后，若解析正确，在上方会显示“Your site is published at xxxxxx”，如上图另一个框所示。

  • 2.3、配置SSH key

​ ​  执行如下命令

1
$ ssh-keygen -t ras -C "邮件地址"

​ ​  如图所示

​ ​  出现如图字样，说明安装成功，再连续回车3次即可。安装成功会显示密钥路径，根据路径找到文件，打开id_rsa.pub文件，将其内容全部复制。

​ ​ 打开github网站，点击设置，如图。粘贴上一步复制的内容到Key位置，Title随便输入。

​ ​ 输入

1
$ ssh -T git@github.com

​ ​ 出现下图表示配置成功。

1
$ Hi jiangnan1q! You've successfully authenticated, but GitHub does not provide shell access.

​ ​ 如图所示

hexo安装及部署

  • 3.1、hexo 安装

​ ​ 打开powershell，输入命令 npm install -g hexo-cli

  • 3.2、初始化hexo

​ ​ 在你想要安装hexo的位置新建一个空文件夹，在powershell中进入该目录，输入命令 ```hexo init`` ，初始化成功如下图：

​ ​ 目录结构如图所示：

  • 3.3、测试hexo

​ ​ 使用以下命令启动hexo：

1
2
$ hexo g
$ hexo s

​ ​ 打开浏览器，输入localhost:4000，查看hexo是否成功初始化。

​ ​ 初始化的界面如下所示：

  • 3.4、hexo部署

​ ​ 在powershell中依次执行以下命令

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

​ ​ 打开hexo目录下的_config.yml文件，拉倒最下面，按照图片配置，其中repository是前面新建的xxx.github.io的地址。

​ ​ ps：建议使用能够检查yaml语法的编辑器，避免由于缩进错误引起的语法错误。

​ ​ 最后使用 hexo d 完成远程部署。

  • 3.5、关于部署与个人域名的注意事项

    由于hexo在部署的时候会将本地的文件同步到远程，而之前 2.2、绑定个人域名 时自动生成的CNAME文件会被删除。有以下两种方式：

    ​ ①进入hexo根目录下/.deploy_git，输入以下命令

1
$ git pull

​ ​ ​ 等待文件同步完成后，拷贝CNAME文件到hexo根目录/source/下

​ 执行以下命令即可。

1
2
3
$ hexo clean
$ hexo g
$ hexo d

​ ​ ​ ​②直接进入hexo根目录下/source/，创建文件CNAME（没有文件格式，使用TXT文本打开进行编辑），输入内容为个人域名，如下图：

​ ​ ​ 之后同样执行以下命令即可完成部署。

1
2
3
$ hexo clean
$ hexo g
$ hexo d

最后

​ 最后，放上今天刚获得的表情包。