草台班子建站历程(基于Hexo框架、GitHub-pages部署) | 草台班子

LOADING

加载过慢请开启缓存 浏览器默认开启

草台班子建站历程(基于Hexo框架、GitHub-pages部署)

2024/8/22 笔记

hexo的官方文档实在是过于构式,写下本文记录简单高效的流程

前置准备

  • Git
  • Node.js
  • npm & pnpm

框架搭建

  1. 使用npm全局安装hexo
    npm install -g hexo-cli
  2. 创建一个空文件夹,进入文件夹,构建hexo
    hexo init
  3. 接下来先选择主题,hexo官网有四百多个主题供选择,选中心仪的主题后在theme文件夹中拉取
    例如我的主题是ParticleX:
    git clone https://github.com/theme-particlex/hexo-theme-particlex.git particlex --depth=1
    之后在根目录_config.yml修改
    theme: ParticleX
    以上步骤只是一个通用方式,具体配置还需参考对应主题的文档

Github-pages部署

  1. 首先在GitHub创建一个public的空仓库,确保仓库只有一条分支即main,且仓库必须为.github.io,仓库必须为空!
  2. 打开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
  3. 接下来将得到的SSH密钥添加到Github中即可,可以使用以下命令查看是否添加成功:
    ssh -T git@github.com
  4. 在yml文件中添加以下配置:
    url: https://<user>.github.io/
    deploy:
    type: git
    repo: git@github.com:<user>/<user>.github.io.git
    branch: main
    message:
  5. 安装部署所需的插件:
    pnpm add hexo-deployer-git
  6. 在根目录下运行以下命令部署:
    hexo deploy
  7. 等待部署完成,打开浏览器访问https://.github.io/即可看到自己的博客啦!