文章的初衷#
博客的目的是写作而不是展示自己技術的地方，所以本文以方便快速的角度出發，帶小白們認識一下 hugo 的魅力。
需要準備的#
- 能快速打開 Github 的電腦（推薦掛梯子，否則寫文章容易丟失）
- 學習 Markdown（很簡單，工具推薦 Typora，0 學習成本，像編輯 Word 文件一樣編輯 Markdown）
搭建博客#
- 訪問CaiJimmy/hugo-theme-stack-starter點擊Use this template按照提示完成操作
- 完成操作後，點擊Code創建新的 Codespace
配置博客#
打開 Codespace，打開config/_default/這裡的文件就是博客配置。
修改 config.toml#
下面是各行需要修改的地方
| 名稱 | 需要的操作 |
|---|---|
| baseurl | 修改為自己博客的網址，格式：（//: 網址） |
| languageCode | 修改為網站的語言，這裡寫 zh-cn |
| paginate | 每頁顯示文章數，保持原樣即可 |
| title | 網站標題，如 "百度" |
| DefaultContentLanguage | 支持 en, fr, id, ja, ko, pt-br, zh-cn, zh-tw, es, de, nl, it, th, el, uk, ar。填寫 zh-cn |
其他的不用管
修改 menu.toml#
在基礎上進行修改即可
修改 params.toml#
-
footer
since: 填寫博客創建日期，如 2023
customText: 自定義頁腳文字，效果見本站頁腳
-
dateFormat
不用改，改了可能會出錯
-
sidebar
emoji: 頭像右下角的圖標，填寫 emoji 即可
subtitle: 博客頭像下的一段文字，不建議太長
-
sidebar.avatar
local: 頭像是否在本地，如果在本地請填寫 true！
src: 頭像連結
其他的不用管
部署博客#
修改.github/workflows內的 deploy.yml (沒有的新建)，刪除內容後填寫：
name: Deploy to Github Pages
on:
push:
branches: [master]
pull_request:
branches: [master]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Cache Hugo resources
uses: actions/cache@v2
env:
cache-name: cache-hugo-resources
with:
path: resources
key: ${{ env.cache-name }}
- uses: actions/setup-go@v2
with:
go-version: "^1.17.0"
- run: go version
- name: Cache Go Modules
uses: actions/cache@v2
with:
path: |
~/.cache/go-build
~/go/pkg/mod
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
restore-keys: |
${{ runner.os }}-go-
- name: Setup Hugo
uses: peaceiris/actions-hugo@v2
with:
hugo-version: "latest"
extended: true
- name: Build
run: hugo --minify --gc
- name: Deploy 🚀
uses: JamesIves/github-pages-deploy-action@v4
with:
branch: gh-pages
folder: public
clean: true
single-commit: true
新建分支
點擊 New branch
打開倉庫 > settings>Actions>General，按圖修改
上傳到 Github
輸入
git init
git add .
git commit -m "commit"
git push origin master
部署至 Netlify#
先註冊一個賬號，然後新建站點，選擇從 Git 倉庫導入
點擊 Github 後等彈窗顯示文字，關閉即可看到倉庫，選擇博客倉庫，選擇 gh-pages
其他的不用管點 Deploy site。到首頁訪問鏈接即可看到博客（每次更新博客不用手動重新部署，過程是自動的）