使用 GitHub Pages 搭建个人博客

准备 GitHub 仓库

首先你要创建一个 GitHub 仓库, 仓库名应为: <当前github用户名>.github.io

比如:

我的github用户名是 james

那么, 我用来做博客的仓库名就必须是 james.github.io

仓库的可见性, 官方文档没做说明, 所以我选择了默认的 Public

软件环境准备

git & node.js

这两个我机器之前就已经装了

^{GitHub官方建议} jekyll

Adding content to your GitHub Pages site using Jekyll
一开始我照着官方的建议来的

无奈手册有点杂乱, 使用 jekyll 现需要 ruby, 安装 jekyll 官方又推荐使用 Bundler

总之最后没搞起来, 改用 hexo 了

hexo

直接 CMD 里面执行

npm install -g hexo-cli
# 这条是让 hexo 支持 git 一键部署
npm install hexo-deployer-git --save

实际使用

新建 博客 项目

准备一个空文件夹用于博客的 hexo 工作目录

在 git bash 中切换至该目录使用 hexo init 来初始化项目

这个命令会在目标文件夹下生成 hexo 项目的基本框架

修改配置文件

编辑工作目录下的 _config.yml 文件的 deploy 段

deploy:
###
# type: git, 使用git部署固定该值
# repo: 填入你的博客仓库地址, 就是之前提到的 <当前github用户名>.github.io
# branch: 指定部署用的分支, 你可以不用 GitHub 上的 main 或者 master 分支来部署, 自行建立一个分支用于博客
# message: 可选项, 它用来在部署时自动填上 git 的 commit 备注
###
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]

修改 git 配置

在项目根目录下 cd .deploy_git 可以进入项目使用的 git 目录
如果对于该博客有自己另外使用的 git 信息, 可以使用如下命令指定提交者信息

git config user.name <提交者名字>
git config user.email <提交者邮箱>

实际创作

使用 hexo new <标题> 即可创建一篇新的文章

默认文章的文件会生成在 source/_posts 下面

博客更新

文章编写完成后, 可以使用如下命令来进行发布

# 生成对应的静态页面
# 完整命令是 hexo generate
hexo g
# 发布
# 完整命令是 hexo deploy
hexo d

---

至此, 使用 hexo 在 GitHub 搭建个人博客完成