Hugo的自定义主题实现和使用介绍,主要包括自定义模板,HintBox, Tab, Anchor Navigation, Code Copy, 等功能。以及如何修改默认表格样式等。
Hugo常用功能
Archetypes
原型 (Archetype)本质上是一个预定义的 Markdown 文件模板。它包含了新内容文件创建时应有的默认前置元数据
字段和值,以及可选的初始 Markdown 内容
- 原型文件存放在 Hugo 项目(或主题)根目录下的
archetypes/
文件夹中 - 可以创建多个原型,可以通过
--kind
(或-k
) 标志明确指定要使用的原型名称(不含.md
后缀)
bash
hugo new posts/demo.md --kind blog
# Hugo 会查找 archetypes/blog.md
原型的选择顺序——如何确定使用哪个 Archetype
除了上述的明确指定原型名称外,Hugo 在执行 hugo new 命令时,会按照以下顺序(大致)来查找和选择原型文件:
-
根据内容所在的区段 (Section): Hugo 会首先在该区段对应的原型目录中查找。 例如:
content/posts/some-subdir/new.md
Hugo 是一个基于 Go 语言的现代的静态站点生成器。Hugo 提供了 强大的模板引擎 和 灵活的主题系统,并支持 Shortcodes 和 Hooks 扩展功能。
Hugo Introduction
Hugo
v0.146.0
模板系统变更
layouts/_default/
目录已移除,所有文件移至layouts/
根目录layouts/partials/
→layouts/_partials/
layouts/shortcodes/
→layouts/_shortcodes/
安装和初始化
下面将介绍 Windows 下的安装方式,其他平台参照:MacOS, Linux
方式一:在 Git Bash
或 PowerShell
中使用 winget
命令安装:
bash
winget install Hugo.Hugo.Extended
卸载命令:winget uninstall --name "Hugo (Extended)"
Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。
常用语法
- 标题: 使用
#
号,例如# 一级标题
,## 二级标题
。 - 列表: 使用
*
,+
, 或-
创建无序列表,使用数字加点创建有序列表。 - 链接:
[链接文本](链接地址)
- 图片:

高级特性
代码块,表格