Hexo 博客搭建教程

前言#

这个博客起源于2020年暑假发现的 Gridea ，然后这个其实当时也是比较新的软件（RT

然后部署了一个基于 Gridea + Github Page 的博客（也是现在这个网址）

好处就是有客户端，但是主题太少自由度不高，后来就放弃 Gridea 转向 Hexo 了。（其实也是因为自己很久没维护了）

虽然同样是静态博客生成器，也是 Github Page 部署，Hexo的社区生态可能就要丰富一些qwq

搭建过程#

其实 Hexo文档 里就有

1
npm install -g hexo-cli

1
hexo init my-blog
2
cd my-blog
3
npm install

1
.
2
├── _config.yml   # 网站配置文件
3
├── package.json  # 应用程序信息
4
├── scaffolds     # 模板文件夹
5
├── source        # 资源文件夹
6
|   ├── _drafts
7
|   └── _posts
8
└── themes        # 主题文件夹

1
hexo g
2
hexo s

1
git clone https://github.com/jerryc127/butterfly-theme.git themes/butterfly

部署#

我使用的是 GitHub Pages，当然也可以部署到别的平台或者自己的服务器上。

具体步骤如下

• 注册 Github 账号

• 建立一个名为 你的用户名.github.io 的仓库

• 安装 hexo-deployer-git：

  1
  npm install hexo-deployer-git --save

• 如果你不想提供用户名和密码，可以配置 SSH 进行部署

  Warning

注意你的 Windows 用户名应不含中文 :::

• 修改 _config.yml

  1
  deploy:
  2
  type: git
  3
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  4
  branch: main
  5
  url: https://你的用户名.github.io/

• 在博客文件夹下右键，Git Bash Here

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

• 然后生成 SSH 密钥

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

• （可选）添加 SSH 配置文件（似乎是 Github 默认的22端口不能用了要换成443端口？）

  运行以下命令创建配置：

  1
  touch ~/.ssh/config

  然后用记事本打开编辑：

  1
  notepad ~/.ssh/config

  在打开的文件里粘贴以下内容：

  1
  Host github.com
  2
  Hostname ssh.github.com
  3
  User git
  4
  Port 443

  保存并关闭。

• 把公钥添加到 GitHub

  查看公钥内容：

  1
  cat ~/.ssh/id_rsa.pub

  复制输出的内容（以 ssh-rsa 开头的那一长串）。

  在 GitHub 上添加：

  1. 打开 https://github.com/settings/keys
  2. 点击 “New SSH key”
  3. Title 随便填
  4. Key 粘贴刚才复制的公钥
  5. 点击 “Add SSH key”

• 测试连接

  1
  ssh -T git@github.com

  成功的话会显示：

  1
  Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.

• 然后执行

1
hexo clean  # 清除缓存文件和生成的静态文件
2
hexo g      # 生成静态文件
3
hexo d      # 部署

过一会即可在 https://你的用户名.github.io/ 上看到你的博客啦~

主题配置#

具体主题配置参考 Butterfly主题文档

以下是我个人使用的一些配置

1
npm install hexo-abbrlink --save