Skip to content

Commit

Permalink
Clarify the default for site config files and multiple config files
Browse files Browse the repository at this point in the history
Add examples on how to set multiple site config files.

Fixes #146
  • Loading branch information
kaushalmodi committed Mar 15, 2018
1 parent c87c9c6 commit dc26e0a
Showing 1 changed file with 19 additions and 4 deletions.
23 changes: 19 additions & 4 deletions content/getting-started/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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.

Expand Down

0 comments on commit dc26e0a

Please sign in to comment.