配置Hugo

配置Hugo

如何配置您的Hugo站点

配置文件

Hugo使用 hugo.toml、hugo.yaml或者hugo.json（如果位于站点根目录中找到）作为默认的站点配置文件。

用户可以选择使用命令行的--config开关来覆盖这个默认值，一个或多个站点配置文件。

示例：

hugo --config debugconfig.toml
hugo --config a.toml, b.toml, c.toml

多个站点配置文件可以使用逗号分隔的字符串传递给--config开关。

hugo.toml与config.toml

在Hugo 0.110.0版本中，我们将默认配置基本文件名更改为hugo，例如hugo.toml。 但我们仍然可以找到config.toml等文件，但我们建议您最终将其重命名（但如果您想要支持旧版本的Hugo，则需要等待）。 我们这样做的主要原因是使代码编辑器和构建工具更容易识别这个文件，知道它是一个Hugo配置文件和项目。

New in v0.110.0

配置目录

除了使用单个站点配置文件外，您可以使用configDir目录（默认为config/）来更轻松地组织和管理特定于环境的设置。

• 每个文件都代表一个配置根对象，例如Params对应于params.toml，Menu对应于menu(s).toml，Languages对应于languages.toml等等……
• 每个文件的内容必须是顶级的，例如：

hugo.yaml

PLAINTEXT

折叠 复制

Params:
  foo: bar

点击展开查看更多

hugo.toml

PLAINTEXT

折叠 复制

[Params]
  foo = 'bar

点击展开查看更多

hugo.json

PLAINTEXT

折叠 复制

{
  "Params": {
    "foo": "bar"
  }
}

点击展开查看更多