Hugo传统的部署安装

全文参考Hugo_+Github_Pages_搭建个人博客|_Robin_的个人主页-2025-04-29.html

新建仓库

注意新建page仓库的时候命名有要求

本地安装

其实本地也不用安装,直接部署到Github Actions或者Vercel也行。

本地安装的话mac推荐用homebrew

安装mac的话直接放出官方的地址

Installation_2025-04-29_05:00:38.798.html

创建站点后再写一篇博文并本地启动

hugo 提供的目录介绍,也有关于挂载的。我的剪藏网页也主要用的是挂载的特性。下面是相关的原网页介绍。

Directory_structure-2025-04-29.html

安装好后直接快速开始。也是直接贴出原链接了。

Quick_start-2025-04-29.html

Github Actions

actions-gh-pages

hugo-setup

先看几个链接,自动部署就是用的这两个脚本。也就是把下面的yaml文件放到.github/workflows/hugo.xml下即可

GitHub Actions是GitHub提供的持续集成/持续部署(CI/CD)服务,可以帮助我们自动构建和部署Hugo站点。下面是配置文件的详细解释:

name: GitHub Pages

on:
  push:
    branches:
      - main  # Set a branch to deploy
  pull_request:

jobs:
  deploy:
    runs-on: ubuntu-22.04
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: true  # Fetch Hugo themes (true OR recursive)
          fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: '0.119.0'
          # extended: true

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        if: github.ref == 'refs/heads/main'
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public

上面脚本中出现的词稍微备注解释一下。

  • on是触发条件

  • jobs部署部分

  • runs-on是环境

  • concurrency以及group是防止并发的

    • 问了一下AI是这么回答的
  • steps是步骤

  • uses后边跟的是用什么脚本

  • github_token需要注意申请,然后再项目中添加上。

    • 申请在Sign in to GitHub · GitHub创建即可。有两种,选一种就行,我直接选的经典的,放开了所有的权限,另一种是细粒度控制的。

    这样的话就能直接push然后自动部署了。

    到此为止访问username.github.io就能访问了。

Vercel

RSS配置相关

Hugo文章目录结构