无题

title: hexo流程
date: 2025-06-17
tags: [hexo]

hexo流程

1.搭建hexo环境，添加主题

安装node

安装hexo

配置主题

在themes文件夹下拉取对应想要的主题

git clone -b main https://github.com/everfu/hexo-theme-solitude.git themes/solitude

把.gitignore文件,.git和.github文件夹删掉，主要是为了后面自动化部署。

配置yml

2.编写md文档

3.生成文件，并推送

hexo deploy (Hexo 会将 public 目录中的文件和目录推送至 _config.yml 中指定的远端仓库和分支中，并且完全覆盖该分支下的已有内容。)

4.同步仓库到github(源码管理)

hexo d 只是推送了生成的静态文件到我们指定的分支。但是我们的源码该如何管理。

1.在github创建新分支source,

新分支创建后，因为来源于之前的mian分支，会有之前的文件代码。我们主要是想在这个分支管理源码

在setting里将默认分支切换成新建的分支source,这样我们git clone 时拉取的就是源码了。

2.将本地hexo目录与远程仓库关联

进入本地hexo工程目录，

初始化git仓库

1)git init

如果要取消初始化，直接删除.git文件夹

2)添加远程地址，使用ssh方式。

使用https方式后续push时需要验证用户名密码，git已不支持这种方式验证。如果已添加远程库，可以用

git remote rm origin 去除远程库。

git remote add origin git@github.com:smallmayi/smallmayi.github.io.git

3)添加.gitignore文件，只保留源码，其他不推送

.DS_STORE
db.json
*.log node_modules/ public/ .deploy*/

3)git add .

image-20240607151903306

报错，因为有子仓库，里面的主题也是git拉取

按照提示

git submodule add url themes ,url 为仓库地址

下执行

git submodule add https://github.com/everfu/hexo-theme-solitude.git themes/solitude

当上面在主题目录删除git后提示如下

image-20240627151417477

image-20240627151435813

4)提交远程source分支

git push origin source

提交失败，因为之前远程的souce分支是我们直接从main分支复制的，和我们现在要提交的差异过大(因为我们不是拉取远程进行修改的，我们也不需要pull)，强制推送

git push origin source --force

5）查看仓库

image-20240619165050143

可以看到已成功提交，且已经忽略生成的public文件夹。

2.使用git action

上面我们提交了源码和页面，但是每次写了文章我们需要手动hexo d 推送生成的页面，使用git action自动执行实现我们推送源码后自动执行生成页面。

1）生成个人token

https://github.com/settings/tokens

image-20240621164611994

选择不过期，勾选repo和workflow

生成的token记得复制保存下来，只能看这一次。

2）添加自定token

image-20240711154004113

在setting下添加一个自定义secret,名称自定义，内容为之前的token。

3）去Github的自己仓库点击Actions，新建一个workflow工作流。

里面的依赖等根据情况配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
name: Deploy Hexo to GitHub Pages

on:
  push:
    branches:
      - source  # 当推送到 source 分支时触发

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v2
        with:
          submodules: false  # 禁用子模块检查
          
      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '18'

      - name: Install Dependencies
        run: npm install

      - name: Install Hexo Git Deployer
        run: |
          npm install hexo-deployer-git --save
          npm install hexo-cli -g
          npm install hexo-renderer-pug hexo-renderer-stylus --save
      - name: Clean and Generate Static Files
        run: |
          hexo clean
          hexo generate
      - name: Configure Git
        run: |
          git config --global user.name 'smallmayi'
          git config --global user.email '1591698916@qq.com'
      - name: Deploy to GitHub Pages
        env:
          GH_TOKEN: ${{ secrets.BLOGAUTO }}
        run: |
          cd public/
          git init
          git add -A
          git commit -m "update by workflows"
          git remote add origin https://${{ secrets.BLOGAUTO }}@github.com/smallmayi/smallmayi.github.io.git
          git push origin HEAD:main -f

现在就配置好了，后续只需要在_post添加文章上传就行，会自动部署生成文件。