hexo的官方文档实在是过于构式,写下本文记录简单高效的流程
前置准备
- Git
- Node.js
- npm & pnpm
框架搭建
- 使用npm全局安装hexo
npm install -g hexo-cli
- 创建一个空文件夹,进入文件夹,构建hexo
hexo init
- 接下来先选择主题,hexo官网有四百多个主题供选择,选中心仪的主题后在theme文件夹中拉取
例如我的主题是ParticleX:git clone https://github.com/theme-particlex/hexo-theme-particlex.git particlex --depth=1
之后在根目录_config.yml修改
theme: ParticleX
以上步骤只是一个通用方式,具体配置还需参考对应主题的文档
Github-pages部署
- 首先在GitHub创建一个public的空仓库,确保仓库只有一条分支即main,且仓库必须为
.github.io,仓库必须为空! - 打开Git Bash,获取SSH密钥
ssh-keygen -t ed25519 -C <email>
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
由于本人是Windows系统,接下来打开powershell:
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard
- 接下来将得到的SSH密钥添加到Github中即可,可以使用以下命令查看是否添加成功:
ssh -T git@github.com
- 在yml文件中添加以下配置:
url: https://<user>.github.io/
deploy:
type: git
repo: git@github.com:<user>/<user>.github.io.git
branch: main
message:
- 安装部署所需的插件:
pnpm add hexo-deployer-git
- 在根目录下运行以下命令部署:
hexo deploy
- 等待部署完成,打开浏览器访问https://
.github.io/即可看到自己的博客啦!