如何在GitHub上部署Hexo博客

前提条件

在开始之前,确保你已经完成了以下几步:

  1. 安装Node.js
  2. 安装Git
  3. 拥有一个GitHub账户。
  4. 创建一个名为<your-username>.github.io的新仓库,其中<your-username>是你的GitHub用户名。

安装Hexo

首先,通过npm安装Hexo命令行工具:

1
npm install -g hexo-cli

接着,初始化你的Hexo项目:

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

配置你的Hexo博客

修改 _config.yml 文件,确保至少修改以下部分:

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: git@github.com:<your-username>/<your-username>.github.io.git
branch: master

记得将 <your-username> 替换成你的GitHub用户名。

安装部署插件

为了使Hexo能够部署到GitHub Pages,你需要安装 hexo-deployer-git 插件:

1
npm install hexo-deployer-git --save

生成静态文件并部署

现在,你可以通过以下命令生成静态文件并部署到GitHub Pages:

1
2
3
hexo clean
hexo generate
hexo deploy

访问你的博客

部署完成后,你可以通过访问 https://<your-username>.github.io 来查看你的Hexo博客。

结语

恭喜你!现在你已经成功在GitHub Pages上部署了自己的Hexo博客。你可以开始自定义主题、发布文章和分享你的知识了。


希望这篇教程对你有所帮助,如果有任何问题,欢迎在评论区留言讨论。

1