Hugo 架站筆記

· · 閱讀時間 3 分鐘

大綱由 Sheng 整理，內文由 ChatGPT 填充。

更正（2026-11-02 18:45）：刪掉「圖也是 ChatGPT 生的」這句（修正建議：Claude，經 Codex（gpt-6-astra）、Grok 與 Claude Fable 投票決定）；用自訂模板新增文章的指令改為 hugo new --kind posts post/test.md，模板存成 archetypes/posts.md（修正建議：Codex（gpt-6-astra），Claude 驗證）。

1. 安裝 Hugo

照官方文件走就好：

Installation | Hugo (gohugo.io)

2. 建立網站

裝好之後跟著 Quick Start 操作，幾分鐘就能把骨架跑起來：

Quick start | Hugo (gohugo.io)

3. 選 Theme

我用的是 Hugotex，再自己改了一些細節。其他選項可以直接到 Hugo Themes 比較。

完整清單：Hugo Themes

4. 部署到 GitHub Pages

網站做好就推上去。建議搭配 GitHub Actions 自動部署，push 到 main 就直接上線。

Deploying Hugo on GitHub Pages

常用指令

新增文章：

hugo new post/your-awesome-title.md

自訂 archetype 模板：

在 archetypes/ 建一個範本，存成 archetypes/posts.md，之後用 --kind posts 新增文章就會套用：

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
author: "Sheng"
description: ""
tags: []
keywords: []
---

用自訂模板新增文章：

hugo new --kind posts post/test.md

補充筆記

  • 安裝和建站照官方的 Installation 與 Quick Start 走，幾分鐘就能把骨架跑起來。
  • Theme 用 Hugotex 再自己改細節，其他選項到 Hugo Themes 比較。
  • 部署到 GitHub Pages 搭配 GitHub Actions，push 到 main 就上線。
  • 在 archetypes/posts.md 放自訂範本，用 hugo new --kind posts 新增文章時自動套用同一組 frontmatter。

Sheng 撰寫，Claude 協助文字與範例 · 列入 20260613 blog 翻新計劃，新漆未乾。