安装与配置指南

Wed, 08 Jan 2025 00:00:00 +0000

安装

把主题放入 Hugo 站点的 themes/ 目录，然后在 config.toml 声明：

1theme = "period"

配置从模板开始最省事：把 config.toml.example 复制为 config.toml 再改。

核心参数速查

 1[params]
 2 tagline = "记录设计、代码与生活的个人博客。" # 页眉标语
 3 description = "站点描述" # 首页 meta/OG/JSON-LD
 4 author = "Leanku" # 默认作者（front matter 可覆盖）
 5 dateFormat = "2006年1月2日" # Go 时间布局
 6 layout = "right" # right | left —— 侧边栏位置
 7 fullPost = false # true = 列表页显示全文而非摘要
 8 excerptLength = 40 # 自动摘要字数（无 description 时生效）
 9 readMoreText = "阅读更多" # 摘要按钮文字
10 displayAuthor = true # 署名显示作者
11 displayDate = true # 署名显示日期
12 lastUpdated = true # 显示"最后更新于"
13 scrollToTop = true # 返回顶部按钮
14 logo = "" # logo 路径（static/ 下）；留空用文字标题
15 logoSize = 168 # logo 宽度 px
16 searchBar = true # 页眉搜索按钮
17 footerText = "版权说明" # 页脚 credit 条
18 googleFonts = true # 加载 Google Fonts（false = 离线系统字体）
19 fontFamily = "Roboto:300,300italic,400,700"
20 fontSubsets = "latin,latin-ext"

侧栏组件

1[params.sidebar]
2 recentPosts = 5 # 最近文章；0 = 不显示
3 categories = true # 分类列表（带计数）
4 tags = true # 标签云
5 archives = true # 按月归档（链接到 /archives/#2025-01）
6 [params.sidebar.about] # 关于组件（参考 laruence.com 紧凑样式）
7 name = "Leanku" # 加粗名字
8 image = "images/avatar.jpg" # 81×50 小头像（object-fit: cover）
9 text = "简介，支持 Markdown 链接"

导航菜单（含嵌套）

 1[menu]
 2 [[menu.main]]
 3 name = "主页"
 4 url = "/"
 5 weight = 1
 6 identifier = "home"
 7 # 嵌套子菜单：用 parent 指向父项 name
 8 [[menu.main]]
 9 name = "专题"
10 weight = 8
11 [[menu.main]]
12 name = "AI"
13 url = "/post/ai/"
14 parent = "专题"

weight 决定顺序；identifier 为 rss 时菜单自动加 fa-rss 图标；
当前页自动高亮（current-menu-item + aria-current="page"），以菜单 url 与页面地址精确匹配为准。

⚠️ TOML 陷阱（必读）

TOML 中一旦出现子表表头，其后的所有键都归属该子表，直到下一个表头：

配置 on Leanku 的博客

安装与配置指南

安装

核心参数速查

侧栏组件

导航菜单（含嵌套）

⚠️ TOML 陷阱（必读）