mirror of
https://github.com/tiennm99/hugoDocs.git
synced 2026-10-14 06:17:45 +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:
1 parent
c87c9c62e1
commit
dc26e0a5a6
1 file changed
+19
-4
@@ -18,10 +18,28 @@ aliases: [/overview/source-directory/,/overview/configuration/]
|
|||||||
toc: true
|
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
|
## 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")
|
archetypeDir ("archetypes")
|
||||||
: The directory where Hugo finds archetype files (content templates).
|
: The directory where Hugo finds archetype files (content templates).
|
||||||
@@ -44,9 +62,6 @@ buildFuture (false)
|
|||||||
canonifyURLs (false)
|
canonifyURLs (false)
|
||||||
: Enable to turn relative URLs into absolute.
|
: Enable to turn relative URLs into absolute.
|
||||||
|
|
||||||
config ("config.toml")
|
|
||||||
: Site config file.
|
|
||||||
|
|
||||||
contentDir ("content")
|
contentDir ("content")
|
||||||
: The directory from where Hugo reads content files.
|
: The directory from where Hugo reads content files.
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user