0成本通过Hugo和GitHub Pages搭建博客 // CYRUS STUDIO

版权归作者所有，如有转发，请注明文章出处：https://cyrus-studio.github.io/blog/

使用 Chocolatey 安装 Hugo

Chocolatey 是一个 Windows 软件包管理器，使用 PowerShell 和 NuGet 作为基础。它可以自动化软件的安装、升级和卸载过程。

安装 Chocolatey（如果还没有安装）

Chocolatey 允许你通过设置环境变量来更改默认安装路径。在安装 Chocolatey 之前，你需要设置 ChocolateyInstall 环境变量来指定新的安装路径。

打开 PowerShell（以管理员身份运行），并执行以下命令指定自定义安装路径：

1. [System.Environment]::SetEnvironmentVariable('ChocolateyInstall', 'D:\App\chocolatey', [System.EnvironmentVariableTarget]::Machine)

如果不设置默认安装路径为：C:\ProgramData\chocolatey

设置完 ChocolateyInstall 环境变量后，重新打开一下会话，执行下面的命令检查一下是否设置成功

Get-Item Env:ChocolateyInstall

打开 PowerShell（以管理员身份运行），执行以下命令安装 Chocolatey：

1. Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

检查是否安装成功

choco -h

安装 Hugo

在 PowerShell 中运行以下命令安装 Hugo：安装软件包：

choco install hugo -confirm

升级软件包：

choco upgrade hugo

卸载软件包：

choco uninstall hugo

验证安装：

1. hugo version

创建 Hugo 网站

1. 创建 Hugo 网站

打开终端或命令行，执行以下命令：

1. # 导航到目标目录
2. cd D:/

# 创建目标目录并进入
mkdir hugo
cd hugo

# 在当前目录下创建 Hugo 站点 cyrus
hugo new site cyrus

2. 添加主题

官方主题网站：https://themes.gohugo.io/

你可以选择一个喜欢的主题并添加到你的 Hugo 网站。例如：

1. git init
2. git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

在 hugo.toml 文件中添加 theme = “ananke”，表示使用 themes 下的 ananke 主题

由于 ananke 主题使用 SCSS/SASS，Hugo标准版是不支持的。 Hugo 的扩展版包含了对 SCSS/SASS 等高级功能的支持，通过以下命令升级到扩展版

choco upgrade hugo-extended -confirm

3. 创建内容

生成一个新的博客文章：

1. hugo new posts/my-first-post.md

编辑 content/posts/my-first-post.md 文件，添加你的文章内容。

4. 本地预览

运行以下命令来本地预览你的博客：

1. # 启动服务器
2. hugo server
3. # 或
4. # 启动本地开发服务器，包括草稿内容在内。
5. hugo server -D

打开浏览器访问 http://localhost:1313 查看你的博客。

5. 生成静态文件

hugo

生成的静态文件会放在 public 目录中。

部署到 GitHub Pages

1. 创建 GitHub 仓库

在 GitHub 上创建一个新的仓库，命名为 blog。

2. 配置 Hugo 部署

在你的 Hugo 项目中，创建 .github/workflows/hugo.yaml 文件，内容如下：

# Sample workflow for building and deploying a Hugo site to GitHub Pages
name: Deploy Hugo site to Pages

on:
  # Runs on pushes targeting the default branch
  push:
    branches:
      - main

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
  contents: read
  pages: write
  id-token: write

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
  group: "pages"
  cancel-in-progress: false

# Default to bash
defaults:
  run:
    shell: bash

jobs:
  # Build job
  build:
    runs-on: ubuntu-latest
    env:
      HUGO_VERSION: 0.128.0
    steps:
      - name: Install Hugo CLI
        run: |
          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
          && sudo dpkg -i ${{ runner.temp }}/hugo.deb          
      - name: Install Dart Sass
        run: sudo snap install dart-sass
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive
          fetch-depth: 0
      - name: Setup Pages
        id: pages
        uses: actions/configure-pages@v5
      - name: Install Node.js dependencies
        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
      - name: Build with Hugo
        env:
          HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
          HUGO_ENVIRONMENT: production
          TZ: America/Los_Angeles
        run: |
          hugo \
            --gc \
            --minify \
            --baseURL "${{ steps.pages.outputs.base_url }}/"          
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

  # Deployment job
  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

Host on GitHub Pages：https://gohugo.io/hosting-and-deployment/hosting-on-github/

修改 baseURL = ‘https://your-username.github.io/blog/'

3. 提交代码并推送到 GitHub

初始化 git 仓库并将代码推送到 GitHub：

1. git add .
2. git commit -m "Initial commit"
3. git branch -M main
4. git remote add origin https://github.com/your-username/your-username.github.io.git
5. git push -u origin main

代码上传完成后，打开【Settings】【Pages】，修改【Source】和【Branch】如下：

4. 查看博客

GitHub Actions 会自动构建并部署你的博客，等待workflow run完，你可以通过 https://your-username.github.io/blog 访问你的博客。

总结

通过以上步骤，你可以使用 Hugo 和 GitHub Pages 0成本地搭建一个博客。这个方法不需要购买域名和托管服务，使用的工具和平台都是免费的。你可以根据需要选择和定制主题，添加内容，并通过 GitHub Pages 免费托管和发布你的博客。