從文章與圖片到子目錄預覽,建立可重現的 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