使用Hugo来组织博客

实际上有两个github仓库,分别是

  • Blog静态资源仓库,仓库名称任意,用来存储博客的笔记即markdown文件
  • $UserName$.gihub.io,必须是用 github.io结尾的仓库,用来存放网站的资源等

每当你上传文件到静态仓库时,触发静态资源仓库的Action,推送到$UserName$.gihub.io仓库

建立资源(md)仓库

1
2
3
4
5
6
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin {你的github仓库地址}
git push -u origin main

github Action

在 hugo 主文件创建一个.github/workflows/xxxx.yaml 文件,将以下内容复制进去,想具体了解更多,可查看【Github Action 文档

 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
name: deploy

# 代码提交到main分支时触发github action
on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
        - name: Checkout
          uses: actions/checkout@v4
          with:
              fetch-depth: 0

        - name: Setup Hugo
          uses: peaceiris/actions-hugo@v3
          with:
              hugo-version: "latest"
              extended: true

        - name: Build Web
          run: hugo -D

        - name: Deploy Web
          uses: peaceiris/actions-gh-pages@v4
          with:
              PERSONAL_TOKEN: ${{ secrets.你的token变量名 }}
              EXTERNAL_REPOSITORY: 你的github名/你的仓库名
              PUBLISH_BRANCH: main
              PUBLISH_DIR: ./public
              commit_message: auto deploy

参考链接

添加小球效果

使用 Hugo 构建
主题 StackJimmy 设计