Hugo 配置工具

建议在电脑上使用

由于配置项较多且操作逻辑较为复杂，为了获得最佳体验，请使用电脑等大屏幕设备访问此工具。

配置预览

hugo.yaml

package.json

点击"预览"按钮查看当前配置

站点基本信息

基础 URL (baseURL)

站点标题 (title)

版权名称 (copyright)

默认内容语言 (defaultContentLanguage)

语言代码 (locale)

时区 (timeZone)

自定义时区 (timeZone)

启用多语言配置 (languages)

站点参数

环境 (params.env)

站点描述 (params.description)

站点关键词（逗号分隔） (params.keywords)

作者 (params.author)

页脚文本 (params.footer.text)

支持 Markdown 格式，例：[备案号](https://beian.miit.gov.cn/)

页脚徽标 (Badges/Shields) (params.footer.badges)

显示在页脚文字上方。推荐使用 Shields.io 生成。

资源设置

网站 favicon (params.assets.favicon)

favicon 16x16 (params.assets.favicon16x16)

favicon 32x32 (params.assets.favicon32x32)

Apple Touch Icon (params.assets.apple_touch_icon)

PWA Icon (192px) (params.assets.manifest_icon_192)

PWA Icon (512px) (params.assets.manifest_icon_512)

Safari Pinned Tab (params.assets.safari_pinned_tab)

导航标签设置

标签文本 (params.label.text)

标签图标 (params.label.icon)

图标高度 (params.label.iconHeight)

默认分享图片 (params.shareImages)

用于 Open Graph / 社交平台分享链接时显示的默认图片 (分享预览图)

列表悬停默认封面图 (params.defaultImage)

当文章未设置 cover.image 时，在列表悬停预览中显示的竖版保底图（3:4 比例）。

文章顶部默认封面图 (params.topDefaultImage)

当文章未设置 topCover 时，在文章页顶部显示的横版保底图（32:5 比例）。需开启下方选项才生效。

在文章顶部显示默认封面图 (params.cover.displayTopDefault)

开启后，即便文章未设置 topCover，也会在文章顶部显示保底图（topDefaultImage）。

首页模式

选择首页模式 (首页显示方式)

模式说明：
• Blog Mode：首页直接显示文章列表，适合博客型站点
• Portal Mode：首页显示自定义信息卡片，下方显示文章列表
• Card Mode：首页居中显示个人信息头像和社交图标，无文章列表

Card Mode 配置 (params.cardMode)

标题 (params.cardMode.title)

副标题 (params.cardMode.subtitle)

头像地址 (params.cardMode.imageUrl)

头像宽度 (params.cardMode.imageWidth)

头像高度 (params.cardMode.imageHeight)

头像标题 (params.cardMode.imageTitle)

按钮列表 (params.cardMode.buttons)

Portal Mode 配置 (params.portalMode)

标题 (params.portalMode.Title)

内容 (params.portalMode.Content)

社交图标对齐方式 (params.portalMode.AlignSocialIconsTo)

Blog Mode 配置

主要内容分区 (params.mainSections)

指定首页显示哪些分区的内容，多个用逗号分隔

禁用特殊的第一篇文章样式 (params.disableSpecial1stPost)

社交图标 (params.socialIcons)

社交图标在 Card Mode 和 Portal Mode 中都会显示，是通用配置。URL(url)和悬停图片(hoverImage)虽然都是可选，但至少要填其中一项。

其他设置

生成 robots.txt (enableRobotsTXT)

每次构建前清理目标目录 (cleanDestinationDir)

构建草稿内容 (buildDrafts)

构建未来发布的内容 (buildFuture)

构建已过期的内容 (buildExpired)

文章加密设置

解密有效期 (秒) (params.authDuration) 默认 3600 (1小时)，0 表示仅限本次访问（不持久化）。此设置仅对本地加密文章生效。

解密页面提示语 (params.authTip) 留空则使用系统默认多语言翻译。可自定义为“如需密码，请联系作者”等。

代码高亮设置

显示代码复制按钮 (params.code.showCopyButtons)

显示行号 (markup.highlight.lineNos)

输出设置

首页输出格式（逗号分隔） (outputs.home)

编辑文章链接

启用编辑链接 (params.editPost)

站点验证与分析

启用站点验证 (params.analytics)

压缩设置

禁用对XML文件的压缩 (minify.disableXML)

对输出进行压缩 (minify.minifyOutput)

渲染设置

允许在 Markdown 中直接书写 HTML (markup.goldmark.renderer.unsafe)

开启后，你可以在文章中直接使用 iframe, div 等 HTML 标签。如果不开启，你必须使用 rawhtml 短代码。

package.json

项目名称 (name)

版本号 (version)

ES 模块已启用 (type: "module") — 支持 import/export 语法

pagefind — 全文搜索依赖 (查看最新版本)

js-yaml — 加密脚本必需的 YAML 解析依赖 (查看最新版本)

通过 package.json 自动管理 Hugo 版本 (hugo-bin)

强制使用主题推荐的 build 命令 (scripts.build)

💡 默认会保留你导入的 package.json 里原有的 scripts（不会被覆盖）；勾选此项则改写成主题推荐的构建命令，包含文章加密与 Pagefind 中文搜索预处理。若你从未导入过 package.json，则无论是否勾选都会写入推荐命令。

建议在电脑上使用

HUGO主题-极简（Jijian）yaml配置工具

配置预览

站点基本信息

站点参数

资源设置

导航标签设置

首页模式

Card Mode 配置 (params.cardMode)

Portal Mode 配置 (params.portalMode)

Blog Mode 配置

社交图标 (params.socialIcons)

其他设置

导航菜单

高级设置

文章加密设置

代码高亮设置

输出设置

编辑文章链接

站点验证与分析

压缩设置

渲染设置

package.json