ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Hugo 基礎:建立文章、圖片與本地建置

任務導覽 TABLE OF CONTENTS

從文章與圖片到子目錄預覽,建立可重現的 Hugo 內容維護與建置流程。

適用:Hugo現行Extended版本與本站NexT版面覆寫。原文的TOML/舊設定保留為歷史對照,實際以config.yaml及部署固定版本為準。

使用本站

先hugo version核對README及workflow要求的Extended版本,主題子模組需初始化。預覽與輸出分開:

git submodule update --init --recursive themes/hugo-theme-next
hugo server --bind 127.0.0.1 --port 1315
hugo --minify --destination /tmp/blog-build-check

網址依終端顯示,本站含/blog/。正式建置不含draft:true;-D僅用於草稿預覽。本站唯一子模組為themes/hugo-theme-next;public是Hugo預設建置輸出,已由Git忽略,可重新產生。正式部署使用暫存產物發布至gh-pages。

新站與文章

新站可hugo new site myblog,再安裝相容主題、配置theme與baseURL。本站新文章用hugo new content post/topic/new-note.md,檢查archetype產生的front matter:

title: "具體的技術主題"
date: 2026-10-06T12:00:00+08:00
lastmod: 2026-10-06T12:00:00+08:00
draft: true
description: "說明用途與讀者能完成的事。"
categories: ["筆記"]
tags: ["Git"]

date記原發布時間,lastmod僅在實際修訂時更新,不能為了看起來新而改原date。本站任務列表用lastmod排序與顯示,每頁10篇、每列最多2篇。

圖片與內部連結

static/images/demo.png對映為images/demo.png,不在網址加/static。baseURL有/blog時優先用Hugo的ref/資源處理以配合部署;本站Markdown圖片render hook處理根路徑的站點字首。圖片必須有描述性alt,純裝飾由版面明確決定空alt。

程式碼用有語言fence,如bash/java/vue,不把原始script放文章HTML。內部文章使用ref,檔案路徑不變即保持既有URL。建置成功後還需查連結、資源、搜尋索引與手機排版。

原hchoco是拼字錯誤;Windows安裝可按Hugo官方方式選hugo-extended,package來源與版本另核對,不任意全域性升級造成CI差異。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文