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:
Kaushal Modi
2018-03-15 12:20:05 -04:00
parent c87c9c62e1
commit dc26e0a5a6
+19 -4
View File
@@ -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.