Hugo 配置文件格式支持：hugo.toml、hugo.yaml、hugo.json，并按照上述顺序索引，支持根据环境、根配置键、语言拆分单个配置文件。
Note
访问 Hugo 文档 查看详细内容。
Hugo Narrow 使用拆分的配置结构，格式采用 YAML。
BASH
1exampleSite/
2├── config/
3│ └── _default/
4│ ├── hugo.yaml
5│ ├── languages.yaml
6│ ├── menus.yaml
7│ └── params.yaml
8└── content/exampleSite/
├── config/
│ └── _default/
│ ├── hugo.yaml
│ ├── languages.yaml
│ ├── menus.yaml
│ └── params.yaml
└── content/
站点配置和一般 Hugo 站点差别不大，较为特殊的是：
permalinks.projects为项目永久链接设置outputFormats.WebAppManifest为主题自动生成WebAppManifest配置highlight.lineNumbersInTable需要设置为falsehighlight.style设置不生效，Hugo Narrow 代码块主题更改需更改样式文件。- Hugo 最低版本为 0.146
YAML
1baseURL: https://hugo-narrow.vercel.app/
2languageCode: en-US
3defaultContentLanguage: en
4defaultContentLanguageInSubdir: false
5title: Hugo Narrow
6theme: "hugo-narrow"
7
8hasCJKLanguage: true
9enableEmoji: true
10
11permalinks:
12 posts: /posts/:slug/
13 projects: /projects/:slug/
14 pages: /:slug/
15
16pagination:
17 pagerSize: 6
18 path: "page"
19
20taxonomies:
21 category: categories
22 tag: tags
23 series: series
24
25markup:
26 tableOfContents:
27 startLevel: 2
28 endLevel: 4
29 ordered: false
30 goldmark:
31 renderer:
32 unsafe: true
33 extensions:
34 extras:
35 delete:
36 enable: true
37 insert:
38 enable: true
39 mark:
40 enable: true
41 subscript:
42 enable: false
43 superscript:
44 enable: false
45 strikethrough: false
46 highlight:
47 codeFences: true
48 guessSyntax: false
49 lineNos: false
50 lineNumbersInTable: false # 设置为 false
51 noClasses: false
52 style: github # 不需要更改
53 tabWidth: 2
54
55outputs:
56 home: ["HTML", "RSS", "JSON", "WebAppManifest"]
57
58# 自定义输出格式
59outputFormats:
60 WebAppManifest:
61 mediaType: "application/manifest+json"
62 baseName: "site"
63 isPlainText: true
64
65module:
66 hugoVersion:
67 extended: true
68 min: 0.146.0baseURL: https://hugo-narrow.vercel.app/
languageCode: en-US
defaultContentLanguage: en
defaultContentLanguageInSubdir: false
title: Hugo Narrow
theme: "hugo-narrow"
hasCJKLanguage: true
enableEmoji: true
permalinks:
posts: /posts/:slug/
projects: /projects/:slug/
pages: /:slug/
pagination:
pagerSize: 6
path: "page"
taxonomies:
category: categories
tag: tags
series: series
markup:
tableOfContents:
startLevel: 2
endLevel: 4
ordered: false
goldmark:
renderer:
unsafe: true
extensions:
extras:
delete:
enable: true
insert:
enable: true
mark:
enable: true
subscript:
enable: false
superscript:
enable: false
strikethrough: false
highlight:
codeFences: true
guessSyntax: false
lineNos: false
lineNumbersInTable: false # 设置为 false
noClasses: false
style: github # 不需要更改
tabWidth: 2
outputs:
home: ["HTML", "RSS", "JSON", "WebAppManifest"]
# 自定义输出格式
outputFormats:
WebAppManifest:
mediaType: "application/manifest+json"
baseName: "site"
isPlainText: true
module:
hugoVersion:
extended: true
min: 0.146.0
主要 Sections
Hugo Narrow 可以配置搜索索引的 Sections，用于全局搜索。
config/_default/hugo.yaml
1mainSections: ["posts", "projects", "pages"]mainSections: ["posts", "projects", "pages"]
主页最近文章列表会使用第一个 Section。