hugo博客开发 - 这篇文章属于一个选集。

§ 2: 本文

上期我们已经实现了hugo站点的搭建，现在我们在让我们的hugo页面更加的美观

这里放上Blowfish的文档页面：Blowfish以供参考

Blowfish的配置主要在hugo.towl、languages.zh-cn.toml、menus.zh-cn.toml和params.toml四个toml文件上，这里说明一下，Blowfish同样支持json格式和yaml格式的配置文件，但是toml是hugo官方和Blowfish官方推荐的配置文件。

hugo.toml
#

首先是theme,这个在Blowfish的入门指南里有写，共有十种不同的配色主题，我这里默认选择blowfish

baseURL是链接的网址，用在需要链接域名的时候

defaultContentLanguage用中文，最终代码是这样

theme = "blowfish" # UNCOMMENT THIS LINE
baseURL = "https://195481.xyz/" #这是要链接的网址
defaultContentLanguage = "zh-cn"#默认语言

languages.zh-cn.toml
#

照着抄，稍微改一下就行

  displayName = "简体中文"
  isoCode = "zh-cn"
  rtl = false
  dateFormat = "2006 Jan 02"
  # logo = "img/logo.jpg"
  # secondaryLogo = "img/secondary-logo.png"
  # description = "My awesome website"
  copyright = "All Rights Reserved © RuChen 2025"

[params.author]
  name = "你的昵称"
  email = "你的邮箱@qq.com"
  image = "img/你的头像.jpg"
  imageQuality = 96
  headline = "你的头衔"
  # bio = "你的简介"

底下的links我就取消注释了一个github，你们随意

menus.zh-cn.toml
#

这是我的配置,照着抄就行

# 主菜单 - 嵌入式笔记 (作为下拉菜单的父项)
[[main]]
  name = "嵌入式学习📖"
  identifier = "embedded"
  url = "/embedded/"
  weight = 10

# 嵌入式下的子菜单
[[main]]
  identifier = "embedded-c"
  name = "C语言专题"
  url = "/embedded/c-language/"  # 指向子分区
  weight = 11                   
  parent = "embedded"           # 关键！指定父菜单的 identifier

[[main]]
  identifier = "embedded-stm32"
  name = "STM32专题"
  url = "/embedded/stm32/"
  weight = 12
  parent = "embedded"

# 主菜单 - 项目日志 (另一个下拉菜单)
[[main]]
  name = "项目日志📒"
  identifier = "projects"
  url = "/projects/"
  weight = 10

# 捣鼓记 (如果没有子项，就保持原样)
[[main]]
  name = "捣鼓日常🛠️"
  identifier = "tinkering"
  url = "/tinkering/"
  weight = 10

[[main]]
  name = "标签🏷️"
  url = "/tags/"
  weight = 30

#友链相关的菜单项
[[main]]
  name = "友链🔗"
  identifier = "friends"
  weight = 20

[[main]]
  name = "Haley's Blog"
  identifier = "friend-somebody"
  parent = "friends"
  url = "https://your_friend_domain.xyz/"
  weight = 20

params.toml
#

这个里面需要配置的东西最多，可以分为很多类，分开来说：

全局
#

全局就是最前面的那一堆，我挑几个重点的：

colorScheme 是颜色方案，选择blowfish默认。
enableSearch是否开启网站的搜索功能，设为true即为启用。
mainSections指定最近文章中应该展示的模块。如果没有指定，则使用文章数量最多的板块。
defaultBackgroundImage设置默认背景图用于background和hero布局下的主页。
defaultFeaturedImage设置默认背景图片用于所有文章的featured图片。
highlightCurrentMenuArea当菜单被选择时，标记主菜单中的菜单项。
smartTOC开启智能目录，视图中的项目将会被高亮显示。

主页homepage
#

layout布局参数。合法的参数值有：page、profile、hero、card、background或custom，我选择background
homepageImage主页背景
showRecent是否在主页展示最新文章列表。我选true
layoutBackgroundBlur向下滚动主页时，是否模糊背景图。
cardView将列表展示为卡片容器。

文章页article
#

showDate是否显示日期。
showDateUpdated是否展示文章的更新日期。
heroStylehero图像的展示样式，可选的参数值有：basic、big、background、thumbAndBackground
showBreadcrumbs是否在标题栏显示面包屑导航。
seriesOpened是否默认显示打开系列模块
showPagination是否在文章末尾展示上一篇/下一篇的文章链接
showTableOfContents是否展示文章的目录
showComments是否在文章末尾添加评论部分
showWordCount是否显示文章的字数

列表页
#

showHero缩略图是否会在每个页面中作为hero图像显示,就是每个文章的图片
heroStylehero 图像的展示样式，这个可以理解为列表页的那张图的放置方式
showBreadcrumbs是否在标题栏显示面包屑导航
layoutBackgroundBlur向下滚动列表页时，是否模糊背景图
groupByYear是否根据年做聚合
cardView将列表展示为卡片容器

最后
#

其他的我就没怎么搞了

作者

RuChen

hugo博客开发 - 这篇文章属于一个选集。

§ 1: hugo博客创建

§ 2: 本文

§ 3: hugo博客评论系统

§ 4: hugo博客图床

hugo.toml#

languages.zh-cn.toml#

menus.zh-cn.toml#

params.toml#

全局#

主页homepage#

文章页article#

列表页#

最后#