mirror of
https://github.com/gohugoio/hugo.git
synced 2026-09-02 11:42:37 +00:00
Clarify the default for site config files and multiple config files
Add examples on how to set multiple site config files. Fixes https://github.com/gohugoio/hugoDocs/issues/146
This commit is contained in:
@@ -18,10 +18,28 @@ aliases: [/overview/source-directory/,/overview/configuration/]
|
||||
toc: true
|
||||
---
|
||||
|
||||
Hugo uses the `config.toml`, `config.yaml`, or `config.json` (if found in the
|
||||
site root) as the default site config file.
|
||||
|
||||
The user can choose to override that default with one or more site config files
|
||||
using the command line `--config` switch.
|
||||
|
||||
Examples:
|
||||
|
||||
```
|
||||
hugo --config debugconfig.toml
|
||||
hugo --config a.toml,b.toml,c.toml
|
||||
```
|
||||
|
||||
{{% note %}}
|
||||
Multiple site config files can be specified as a comma-separated string to the `--config` switch.
|
||||
{{% /note %}}
|
||||
|
||||
## All Configuration Settings
|
||||
|
||||
The following is the full list of Hugo-defined variables with its default value in parens.
|
||||
The following is the full list of Hugo-defined variables with their default
|
||||
value in parentheses. Users may choose to override those values in their site
|
||||
config file(s).
|
||||
|
||||
archetypeDir ("archetypes")
|
||||
: The directory where Hugo finds archetype files (content templates).
|
||||
@@ -44,9 +62,6 @@ buildFuture (false)
|
||||
canonifyURLs (false)
|
||||
: Enable to turn relative URLs into absolute.
|
||||
|
||||
config ("config.toml")
|
||||
: Site config file.
|
||||
|
||||
contentDir ("content")
|
||||
: The directory from where Hugo reads content files.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user