Github action自动部署Hexo Next

本文介绍了使用Hexo和GitHub搭建个人博客的步骤,包括环境准备、Hexo配置和GitHub Pages的关联。重点解决了使用GitHub Actions自动部署时遇到的HTML空白问题,原因是主题目录下的.git与Hexo根目录下的.git冲突。解决方案是删除主题目录下的.git文件夹,重新提交,确保主题文件被正确推送。此外,还提供了Hexo常用命令和相关教程链接。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Hexo + GitHub搭建个人博客

主要分为以下几个步骤:

  1. 搭建环境准备(包括node.js和git环境,gitHub账户的配置)
  2. 安装Hexo
  3. 配置Hexo
  4. 将Hexo与github page 联系起来

详细请看:手把手教你用Hexo+Github 搭建属于自己的博客

GitHub Actions自动部署Hexo

教程:GitHub Actions部署Hexo博客

Hexo 常用命令

新建博客
hexo new "博客名"
生成静态网页
hexo g
打开本地服务器
hexo s

遇到问题

参考:https://www.jianshu.com/p/42453af0853d
只记录本人遇到的问题

  1. Hexo 使用 Github Actions 自动发布至 Github Pages 时,生成的 html 页面空白,没有css/js等文件
    - 原因: 由于主题是 git clone 下来的,主题目录下生成了 .git 目录,导致和 hexo 根目录下 .git 冲突了,commit 时没有把主题 push 上去导致的。
    - 解决办法: 删掉主题下的.git文件夹,重新提交,目的是把next主题文件夹提交上去(删掉.git文件夹后git commit依然没有提交上,需要把next文件夹剪切出来后git add&&git commit &&git push后,再把next文件夹拷贝回来,再git add&&git commit &&git push就可以提交成功了)
### 部署Hexo个人网站到GitHub #### 准备工作 为了成功部署Hexo博客至GitHub,需先安装Node.js和Git工具。确保本地环境已正确设置这些依赖项。 #### 初始化Hexo项目 创建并初始化一个新的Hexo站点: ```bash $ npm install hexo-cli -g $ hexo init myblog $ cd myblog $ npm install ``` #### 修改配置文件 编辑根目录下的`_config.yml`来指定仓库地址和其他必要的参数[^2]: ```yaml deploy: type: git repo: https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.git branch: main token: YOUR_GITHUB_TOKEN ``` 注意替换`YOUR_USERNAME`, `YOUR_REPOSITORY` 和 `YOUR_GITHUB_TOKEN`为实际值。 #### 设置自动部署 利用GitHub Actions实现自动部署流程。在项目的`.github/workflows/`路径下新建名为`ci.yml`的工作流定义文件[^4]: ```yaml name: Deploy Hexo to GitHub Pages on: push: branches: - source # 假设源码存放在source分支上 jobs: build-and-deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: submodules: true - name: Setup Node.js environment uses: actions/setup-node@v1 with: node-version: '12.x' - run: npm ci && npm run generate - name: Deploying... uses: peaceiris/actions-gh-pages@v3 with: github_token: ${{ secrets.GITHUB_TOKEN }} publish_dir: ./public ``` #### 发布文章 撰写新博文后,在终端执行命令完成渲染与推送操作: ```bash $ hexo new post "My New Post" # 编辑完成后... $ hexo clean && hexo d -g ``` 通过上述步骤,即可顺利地将基于Hexo框架构建的内容托管于GitHub平台之上,并借助CI/CD机制保持更新同步。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值