設定ファイル(hugo.toml
)
1# /hugo.toml もしくは
2# /config/_default/hugo.toml
3
4baseURL = "https://example.com/sub/"
5title = "サイト全体のタイトル"
6theme = ["テーマ名"]
7
8# サイト言語の設定
9defaultContentLanguage = "ja"
10defaultContentLanguageInSubdir = false
11hasCJKLanguage = true
12
13# サイトのオプション
14enableEmoji = true
15enableGitInfo = false
16enableMissingTranslationPlaceholder = true
17enableRobotsTXT = true
18
19# ビルド時のオプション設定
20buildDrafts = true
21buildFuture = true
22timeout = "30s"
23
24# パーマリンク設定
25[permalinks]
26pages = "/:section/:filename"
27posts = "/:section/:year/:yearday"
28
29# タクソノミーの設定
30[taxonomies]
31tag = "tags"
32category = "categories"
33author = "authors"
34
35# ページ割の設定
36[pagination]
37pageSize = 20
38
39# ビルドするファイルの設定
40[outputs]
41home = ["HTML", "RSS", "JSON"]
42
43# GAの設定
44[services]
45[services.googleAnalytics]
46ID = "G-測定タグID"
47
48# プライバシー設定
49[privacy]
50[privacy.googleAnalytics]
51disable = true
52respectDoNotTrack = true
サイトの設定はhugo.toml
に記述します。
設定の形式はTOML
/ YAML
/ JSON
が利用できます。
僕はTOML
形式を使っています。
注意
v0.110からデフォルトの設定ファイル名がhugo.toml
に変更されました。
しばらくはconfig.toml
も使えるようですが、hugo.toml
に変更することが推奨されています。
詳しくはhugo.toml vs config.toml - Hugoドキュメントを参照してください。
設定セクション名
設定できるセクション(root configuration keys)は
build
caches
cascade
deployment
frontmatter
imaging
languages
markup
mediatypes
menus
minify
module
outputformats
outputs
params
permalinks
privacy
related
security
segments
server
services
sitemap
taxonomies
です。
たくさんのセクションがありますが、 すべてにHugoのデフォルト設定が用意されています。 カスタムしたいセクションのみ設定ファイルに追加すればOKです。