hugo部署到github

Posted on Edited on Views:

md(markdown)文件发布到博客，通过发现github(github page)是不错的选择，主要是支持自定义域名及cname(不用备案，备案太麻烦了)

env

  • blogs

private repo

  • mvpbang.github.io

public repo

  • github actions
  • hugo
  • github

1.hugo安装

1.1hugo + hugo_extended

二进制文件添加到PATH中

1.2hugo-themes

2.create github repo && add ssh-key

2.1create repo

  • blogs //private md
  • mvbbang.github.io //public github-page

2.2generate ssh-key (deploy_key)

ssh-keygen -t rsa -b 4096 -C "mvpbang@163.com" -f gh-pages -N ""

gh-pages      #私钥
gh-pages.pub  #公钥

-C 指定提交邮箱 -f 生成秘钥前缀

2.3blogs (add private key)

  • Setting -> Secrets -> Actions -> (name: ACTIONS_DEPLOY_KEY)

2.4mvpbang.github.io (add public key)

  • Setting -> Deploy keys -> (name: ACTIONS_DEPLOY_KEY)

点击Deploy keys，添加公钥，Allow write access一定要勾上，否则会无法远程提交

3.add blogs actions

3.1hugo-actions

Actions -> New workflow -> main.yml

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
name: GitHub Pages

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

jobs:
  deploy:
    runs-on: ubuntu-20.04
    concurrency:
      group: ${{ github.workflow }}-${{ github.ref }}
    steps:
      - uses: actions/checkout@v2
        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@v2
        with:
          hugo-version: '0.82.0'
          extended: true

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v3
        with:
          deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }}
          external_repository: mvpbang/mvpbang.github.io   ### 推送到公共仓库用于github-page
          publish_branch: master
          publish_dir: ./public
          cname: mvpbang.com    ### define cname

hugo-themes

github-pages

4.add md && push blogs

4.1create markdown

#创建md
hugo new post/test.md

#本地调试
hugo server -D

http://localhost:1313/

#push到blogs

4.2mvpbang.github.io open github-pages

#source
master ->/

#custom domain
mvpbang.com  (cname www -> mvpbang.github.io)

域名设置dns添加cname

testing

Github Pages访问较慢

  • 可通过自定义域名+CDN加快访问速度

add cloudflare

reference