Squashed 'docs/' changes from a042b67b5..3e663efb2

3e663efb2 Add poster for Hugo 0.31 release
b3c98ba65 Add doc about the new static dir support
2e62e4bdf Update multilingual docs for Hugo 0.31
8eff394b3 commands: Regenerate

git-subtree-dir: docs
git-subtree-split: 3e663efb2b149e243b6ecfdc439a2a2be573987f

diff --git a/content/commands/hugo.md b/content/commands/hugo.md
index a3a5cedf99e9c64ea0d7faa74e29ecd2156b0020..836298378d0bb9598c7bfe0c80bdef1338e484da 100644 (file)
--- a/content/commands/hugo.md
+++ b/content/commands/hugo.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo"
 slug: hugo
 url: /commands/hugo/
@@ -25,45 +25,45 @@ hugo [flags]
 ### Options
 
 ```
-  -b, --baseURL string          hostname (and path) to the root, e.g. http://spf13.com/
-  -D, --buildDrafts             include content marked as draft
-  -E, --buildExpired            include expired content
-  -F, --buildFuture             include content with publishdate in the future
-      --cacheDir string         filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --canonifyURLs            if true, all relative URLs will be canonicalized using baseURL
-      --cleanDestinationDir     remove files from destination not found in static directories
-      --config string           config file (default is path/config.yaml|json|toml)
-  -c, --contentDir string       filesystem path to content directory
-      --debug                   debug output
-  -d, --destination string      filesystem path to write files to
-      --disable404              do not render 404 page
-      --disableKinds strings    disable different kind of pages (home, RSS etc.)
-      --disableRSS              do not build RSS files
-      --disableSitemap          do not build Sitemap file
-      --enableGitInfo           add Git revision, date and author info to the pages
-      --forceSyncStatic         copy all files when static is changed.
-  -h, --help                    help for hugo
-      --i18n-warnings           print missing translations
-      --ignoreCache             ignores the cache directory
-  -l, --layoutDir string        filesystem path to layout directory
-      --log                     enable Logging
-      --logFile string          log File path (if set, logging enabled automatically)
-      --noChmod                 don't sync permission mode of files
-      --noTimes                 don't sync modification time of files
-      --pluralizeListTitles     pluralize titles in lists using inflect (default true)
-      --preserveTaxonomyNames   preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
-      --quiet                   build in quiet mode
-      --renderToMemory          render to memory (only useful for benchmark testing)
-  -s, --source string           filesystem path to read files relative from
-      --stepAnalysis            display memory and timing of different steps of the program
-      --templateMetrics         display metrics about template executions
-      --templateMetricsHints    calculate some improvement hints when combined with --templateMetrics
-  -t, --theme string            theme to use (located in /themes/THEMENAME/)
-      --themesDir string        filesystem path to themes directory
-      --uglyURLs                if true, use /filename.html instead of /filename/
-  -v, --verbose                 verbose output
-      --verboseLog              verbose logging
-  -w, --watch                   watch filesystem for changes and recreate as needed
+  -b, --baseURL string             hostname (and path) to the root, e.g. http://spf13.com/
+  -D, --buildDrafts                include content marked as draft
+  -E, --buildExpired               include expired content
+  -F, --buildFuture                include content with publishdate in the future
+      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --canonifyURLs               if true, all relative URLs will be canonicalized using baseURL
+      --cleanDestinationDir        remove files from destination not found in static directories
+      --config string              config file (default is path/config.yaml|json|toml)
+  -c, --contentDir string          filesystem path to content directory
+      --debug                      debug output
+  -d, --destination string         filesystem path to write files to
+      --disable404                 do not render 404 page
+      --disableKinds stringSlice   disable different kind of pages (home, RSS etc.)
+      --disableRSS                 do not build RSS files
+      --disableSitemap             do not build Sitemap file
+      --enableGitInfo              add Git revision, date and author info to the pages
+      --forceSyncStatic            copy all files when static is changed.
+  -h, --help                       help for hugo
+      --i18n-warnings              print missing translations
+      --ignoreCache                ignores the cache directory
+  -l, --layoutDir string           filesystem path to layout directory
+      --log                        enable Logging
+      --logFile string             log File path (if set, logging enabled automatically)
+      --noChmod                    don't sync permission mode of files
+      --noTimes                    don't sync modification time of files
+      --pluralizeListTitles        pluralize titles in lists using inflect (default true)
+      --preserveTaxonomyNames      preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
+      --quiet                      build in quiet mode
+      --renderToMemory             render to memory (only useful for benchmark testing)
+  -s, --source string              filesystem path to read files relative from
+      --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
+      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
+  -t, --theme string               theme to use (located in /themes/THEMENAME/)
+      --themesDir string           filesystem path to themes directory
+      --uglyURLs                   if true, use /filename.html instead of /filename/
+  -v, --verbose                    verbose output
+      --verboseLog                 verbose logging
+  -w, --watch                      watch filesystem for changes and recreate as needed
 ```
 
 ### SEE ALSO
@@ -80,4 +80,4 @@ hugo [flags]
 * [hugo undraft](/commands/hugo_undraft/)       - Undraft resets the content's draft status
 * [hugo version](/commands/hugo_version/)       - Print the version number of Hugo
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_benchmark.md b/content/commands/hugo_benchmark.md
index 8ffa1cf9b73b5adeda70f3630504608cd9bc9de4..ef3c2423b556c6438e0c9ca868221afe493b92bc 100644 (file)
--- a/content/commands/hugo_benchmark.md
+++ b/content/commands/hugo_benchmark.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo benchmark"
 slug: hugo_benchmark
 url: /commands/hugo_benchmark/
@@ -21,40 +21,40 @@ hugo benchmark [flags]
 ### Options
 
 ```
-  -b, --baseURL string          hostname (and path) to the root, e.g. http://spf13.com/
-  -D, --buildDrafts             include content marked as draft
-  -E, --buildExpired            include expired content
-  -F, --buildFuture             include content with publishdate in the future
-      --cacheDir string         filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --canonifyURLs            if true, all relative URLs will be canonicalized using baseURL
-      --cleanDestinationDir     remove files from destination not found in static directories
-  -c, --contentDir string       filesystem path to content directory
-  -n, --count int               number of times to build the site (default 13)
-      --cpuprofile string       path/filename for the CPU profile file
-  -d, --destination string      filesystem path to write files to
-      --disable404              do not render 404 page
-      --disableKinds strings    disable different kind of pages (home, RSS etc.)
-      --disableRSS              do not build RSS files
-      --disableSitemap          do not build Sitemap file
-      --enableGitInfo           add Git revision, date and author info to the pages
-      --forceSyncStatic         copy all files when static is changed.
-  -h, --help                    help for benchmark
-      --i18n-warnings           print missing translations
-      --ignoreCache             ignores the cache directory
-  -l, --layoutDir string        filesystem path to layout directory
-      --memprofile string       path/filename for the memory profile file
-      --noChmod                 don't sync permission mode of files
-      --noTimes                 don't sync modification time of files
-      --pluralizeListTitles     pluralize titles in lists using inflect (default true)
-      --preserveTaxonomyNames   preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
-      --renderToMemory          render to memory (only useful for benchmark testing)
-  -s, --source string           filesystem path to read files relative from
-      --stepAnalysis            display memory and timing of different steps of the program
-      --templateMetrics         display metrics about template executions
-      --templateMetricsHints    calculate some improvement hints when combined with --templateMetrics
-  -t, --theme string            theme to use (located in /themes/THEMENAME/)
-      --themesDir string        filesystem path to themes directory
-      --uglyURLs                if true, use /filename.html instead of /filename/
+  -b, --baseURL string             hostname (and path) to the root, e.g. http://spf13.com/
+  -D, --buildDrafts                include content marked as draft
+  -E, --buildExpired               include expired content
+  -F, --buildFuture                include content with publishdate in the future
+      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --canonifyURLs               if true, all relative URLs will be canonicalized using baseURL
+      --cleanDestinationDir        remove files from destination not found in static directories
+  -c, --contentDir string          filesystem path to content directory
+  -n, --count int                  number of times to build the site (default 13)
+      --cpuprofile string          path/filename for the CPU profile file
+  -d, --destination string         filesystem path to write files to
+      --disable404                 do not render 404 page
+      --disableKinds stringSlice   disable different kind of pages (home, RSS etc.)
+      --disableRSS                 do not build RSS files
+      --disableSitemap             do not build Sitemap file
+      --enableGitInfo              add Git revision, date and author info to the pages
+      --forceSyncStatic            copy all files when static is changed.
+  -h, --help                       help for benchmark
+      --i18n-warnings              print missing translations
+      --ignoreCache                ignores the cache directory
+  -l, --layoutDir string           filesystem path to layout directory
+      --memprofile string          path/filename for the memory profile file
+      --noChmod                    don't sync permission mode of files
+      --noTimes                    don't sync modification time of files
+      --pluralizeListTitles        pluralize titles in lists using inflect (default true)
+      --preserveTaxonomyNames      preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
+      --renderToMemory             render to memory (only useful for benchmark testing)
+  -s, --source string              filesystem path to read files relative from
+      --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
+      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
+  -t, --theme string               theme to use (located in /themes/THEMENAME/)
+      --themesDir string           filesystem path to themes directory
+      --uglyURLs                   if true, use /filename.html instead of /filename/
 ```
 
 ### Options inherited from parent commands
@@ -72,4 +72,4 @@ hugo benchmark [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_check.md b/content/commands/hugo_check.md
index f732588f95d564c9ee18c80a0ac691712b42ccfb..fa8cc9a029f66db609c0901fc83f4ef26290610c 100644 (file)
--- a/content/commands/hugo_check.md
+++ b/content/commands/hugo_check.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo check"
 slug: hugo_check
 url: /commands/hugo_check/
@@ -35,4 +35,4 @@ Contains some verification checks
 * [hugo](/commands/hugo/)       - hugo builds your site
 * [hugo check ulimit](/commands/hugo_check_ulimit/)     - Check system ulimit settings
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_check_ulimit.md b/content/commands/hugo_check_ulimit.md
index 053618b04fcd011a20bb7d5eaa961c4a51f39e15..6b2554b43ecfa21f308d5c4ee4ea2f46a05ed3e2 100644 (file)
--- a/content/commands/hugo_check_ulimit.md
+++ b/content/commands/hugo_check_ulimit.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo check ulimit"
 slug: hugo_check_ulimit
 url: /commands/hugo_check_ulimit/
@@ -39,4 +39,4 @@ hugo check ulimit [flags]
 ### SEE ALSO
 * [hugo check](/commands/hugo_check/)   - Contains some verification checks
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_config.md b/content/commands/hugo_config.md
index 39ca0a8be3422700b79da903c2f0542a6254a8b2..e45926f1c20c90b745da061c2099a76a5650d6fd 100644 (file)
--- a/content/commands/hugo_config.md
+++ b/content/commands/hugo_config.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo config"
 slug: hugo_config
 url: /commands/hugo_config/
@@ -38,4 +38,4 @@ hugo config [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_convert.md b/content/commands/hugo_convert.md
index 775e37c9475f58e6789892ea8e077652d7cbb568..825350ce169228fba081a925e1ee2a89b3199095 100644 (file)
--- a/content/commands/hugo_convert.md
+++ b/content/commands/hugo_convert.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo convert"
 slug: hugo_convert
 url: /commands/hugo_convert/
@@ -42,4 +42,4 @@ See convert's subcommands toJSON, toTOML and toYAML for more information.
 * [hugo convert toTOML](/commands/hugo_convert_totoml/)         - Convert front matter to TOML
 * [hugo convert toYAML](/commands/hugo_convert_toyaml/)         - Convert front matter to YAML
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_convert_toJSON.md b/content/commands/hugo_convert_toJSON.md
index 6f53030de0af8f6b4a768b5b355bfee0c27d6e2e..42000aa452f1ae2aa474b3360241345929429d0d 100644 (file)
--- a/content/commands/hugo_convert_toJSON.md
+++ b/content/commands/hugo_convert_toJSON.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo convert toJSON"
 slug: hugo_convert_toJSON
 url: /commands/hugo_convert_tojson/
@@ -42,4 +42,4 @@ hugo convert toJSON [flags]
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)       - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_convert_toTOML.md b/content/commands/hugo_convert_toTOML.md
index 2e91e7173fb46bd64b77d42de101b12519d3005e..9d1e30bcf636bdab6f8e47e69b771cfbae115a5b 100644 (file)
--- a/content/commands/hugo_convert_toTOML.md
+++ b/content/commands/hugo_convert_toTOML.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo convert toTOML"
 slug: hugo_convert_toTOML
 url: /commands/hugo_convert_totoml/
@@ -42,4 +42,4 @@ hugo convert toTOML [flags]
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)       - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_convert_toYAML.md b/content/commands/hugo_convert_toYAML.md
index ed0520f08ea59f2bcdaec7df2eb3b288e0b538d8..cb6dac3e97ebe763731ee31a57b5642a4aef3c6e 100644 (file)
--- a/content/commands/hugo_convert_toYAML.md
+++ b/content/commands/hugo_convert_toYAML.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo convert toYAML"
 slug: hugo_convert_toYAML
 url: /commands/hugo_convert_toyaml/
@@ -42,4 +42,4 @@ hugo convert toYAML [flags]
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)       - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_env.md b/content/commands/hugo_env.md
index 3bc5041af1043911545273007106694a3f90378d..38d72686514c47f4549f7a84efcfda8ef2621157 100644 (file)
--- a/content/commands/hugo_env.md
+++ b/content/commands/hugo_env.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo env"
 slug: hugo_env
 url: /commands/hugo_env/
@@ -38,4 +38,4 @@ hugo env [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_gen.md b/content/commands/hugo_gen.md
index c82aeac4cc583045249b75e5682bbb62ebd5b633..3aafee1e3a9bf6dcd774bd59ca929bea6576b1c4 100644 (file)
--- a/content/commands/hugo_gen.md
+++ b/content/commands/hugo_gen.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo gen"
 slug: hugo_gen
 url: /commands/hugo_gen/
@@ -38,4 +38,4 @@ A collection of several useful generators.
 * [hugo gen doc](/commands/hugo_gen_doc/)       - Generate Markdown documentation for the Hugo CLI.
 * [hugo gen man](/commands/hugo_gen_man/)       - Generate man pages for the Hugo CLI
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_gen_autocomplete.md b/content/commands/hugo_gen_autocomplete.md
index e66642916a988f902c0d5b7dff6fb5aea2f22668..024d63427b5f76cb9b56d10b5cc49295b558c5fe 100644 (file)
--- a/content/commands/hugo_gen_autocomplete.md
+++ b/content/commands/hugo_gen_autocomplete.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo gen autocomplete"
 slug: hugo_gen_autocomplete
 url: /commands/hugo_gen_autocomplete/
@@ -56,4 +56,4 @@ hugo gen autocomplete [flags]
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)       - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_gen_chromastyles.md b/content/commands/hugo_gen_chromastyles.md
index 7b70cd4830e2f68dd7e904efa5f8aed06e56148b..d042910eba5102985de4b36a08ecc9e5191a5381 100644 (file)
--- a/content/commands/hugo_gen_chromastyles.md
+++ b/content/commands/hugo_gen_chromastyles.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo gen chromastyles"
 slug: hugo_gen_chromastyles
 url: /commands/hugo_gen_chromastyles/
@@ -43,4 +43,4 @@ hugo gen chromastyles [flags]
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)       - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_gen_doc.md b/content/commands/hugo_gen_doc.md
index a368bc2c16ae0089ffdfa370f163ffa52f07c953..7513b5150c763424abbaceaeb1e0a634f4d148a5 100644 (file)
--- a/content/commands/hugo_gen_doc.md
+++ b/content/commands/hugo_gen_doc.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo gen doc"
 slug: hugo_gen_doc
 url: /commands/hugo_gen_doc/
@@ -45,4 +45,4 @@ hugo gen doc [flags]
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)       - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_gen_man.md b/content/commands/hugo_gen_man.md
index c4f45f3367375ae6dbc805a4a3d4451ff22595ac..e420fec750a788da814271748486f487871583e6 100644 (file)
--- a/content/commands/hugo_gen_man.md
+++ b/content/commands/hugo_gen_man.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo gen man"
 slug: hugo_gen_man
 url: /commands/hugo_gen_man/
@@ -41,4 +41,4 @@ hugo gen man [flags]
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)       - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_import.md b/content/commands/hugo_import.md
index 585945263eb3e5d71661607d9c76ea3d333563d3..04c0cb9b762d25644919631bea94b7cfbeaec0ac 100644 (file)
--- a/content/commands/hugo_import.md
+++ b/content/commands/hugo_import.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo import"
 slug: hugo_import
 url: /commands/hugo_import/
@@ -37,4 +37,4 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p
 * [hugo](/commands/hugo/)       - hugo builds your site
 * [hugo import jekyll](/commands/hugo_import_jekyll/)   - hugo import from Jekyll
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_import_jekyll.md b/content/commands/hugo_import_jekyll.md
index 65dc9a5eab773fb05bc7034208a2a2e44d8d14e5..f46698433cbfdab0fe90cb53fcaac0d0425c4ac1 100644 (file)
--- a/content/commands/hugo_import_jekyll.md
+++ b/content/commands/hugo_import_jekyll.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo import jekyll"
 slug: hugo_import_jekyll
 url: /commands/hugo_import_jekyll/
@@ -41,4 +41,4 @@ hugo import jekyll [flags]
 ### SEE ALSO
 * [hugo import](/commands/hugo_import/)         - Import your site from others.
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_list.md b/content/commands/hugo_list.md
index 07423aba967a5c36202cf24fcce9b91868eea361..df8e8cb840119ccf8846bf0a975fbc870763eebc 100644 (file)
--- a/content/commands/hugo_list.md
+++ b/content/commands/hugo_list.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo list"
 slug: hugo_list
 url: /commands/hugo_list/
@@ -40,4 +40,4 @@ List requires a subcommand, e.g. `hugo list drafts`.
 * [hugo list expired](/commands/hugo_list_expired/)     - List all posts already expired
 * [hugo list future](/commands/hugo_list_future/)       - List all posts dated in the future
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_list_drafts.md b/content/commands/hugo_list_drafts.md
index 853736a35d639e38dea64b9c87b10afa20ac3450..893d7105bdc2889a9f59bf35aefd18cf91def92c 100644 (file)
--- a/content/commands/hugo_list_drafts.md
+++ b/content/commands/hugo_list_drafts.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo list drafts"
 slug: hugo_list_drafts
 url: /commands/hugo_list_drafts/
@@ -39,4 +39,4 @@ hugo list drafts [flags]
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)     - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_list_expired.md b/content/commands/hugo_list_expired.md
index 8de9c7a15d1a4265ee56cb06a4f4ad496af40e4a..846990057e5c301a74ee46f25451abc532690c23 100644 (file)
--- a/content/commands/hugo_list_expired.md
+++ b/content/commands/hugo_list_expired.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo list expired"
 slug: hugo_list_expired
 url: /commands/hugo_list_expired/
@@ -40,4 +40,4 @@ hugo list expired [flags]
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)     - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_list_future.md b/content/commands/hugo_list_future.md
index 243199057dbf1e6b0fde7ad6b8cad8d8593632b1..387558926e6ea5f2eb3e94d61164734c694334dd 100644 (file)
--- a/content/commands/hugo_list_future.md
+++ b/content/commands/hugo_list_future.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo list future"
 slug: hugo_list_future
 url: /commands/hugo_list_future/
@@ -40,4 +40,4 @@ hugo list future [flags]
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)     - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_new.md b/content/commands/hugo_new.md
index 6b4f927db9dcb4493c5338b381a7d25149adabf3..eaa9c3fdf0e5f9b1a5ff290a377a54d207e7c438 100644 (file)
--- a/content/commands/hugo_new.md
+++ b/content/commands/hugo_new.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo new"
 slug: hugo_new
 url: /commands/hugo_new/
@@ -48,4 +48,4 @@ hugo new [path] [flags]
 * [hugo new site](/commands/hugo_new_site/)     - Create a new site (skeleton)
 * [hugo new theme](/commands/hugo_new_theme/)   - Create a new theme
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_new_site.md b/content/commands/hugo_new_site.md
index 4a812179d5ec5edc5d46b426785a5068e21cbe3b..f4b5c2a9a3e3d7fd4b83637d07cfbac7ac550932 100644 (file)
--- a/content/commands/hugo_new_site.md
+++ b/content/commands/hugo_new_site.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo new site"
 slug: hugo_new_site
 url: /commands/hugo_new_site/
@@ -43,4 +43,4 @@ hugo new site [path] [flags]
 ### SEE ALSO
 * [hugo new](/commands/hugo_new/)       - Create new content for your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_new_theme.md b/content/commands/hugo_new_theme.md
index e8718e98af0a66b43bcc69d1b2aa0a5eb9c0af6e..3f3989cd5f1cea14125f18cf5af4067887d2c10a 100644 (file)
--- a/content/commands/hugo_new_theme.md
+++ b/content/commands/hugo_new_theme.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo new theme"
 slug: hugo_new_theme
 url: /commands/hugo_new_theme/
@@ -42,4 +42,4 @@ hugo new theme [name] [flags]
 ### SEE ALSO
 * [hugo new](/commands/hugo_new/)       - Create new content for your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_server.md b/content/commands/hugo_server.md
index 6d722e8aacca86a4dcfb6b0d29816a9b42a1631f..1581ef54b50bfb8e4f2b50afab8409043909ae3f 100644 (file)
--- a/content/commands/hugo_server.md
+++ b/content/commands/hugo_server.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo server"
 slug: hugo_server
 url: /commands/hugo_server/
@@ -31,48 +31,48 @@ hugo server [flags]
 ### Options
 
 ```
-      --appendPort              append port to baseURL (default true)
-  -b, --baseURL string          hostname (and path) to the root, e.g. http://spf13.com/
-      --bind string             interface to which the server will bind (default "127.0.0.1")
-  -D, --buildDrafts             include content marked as draft
-  -E, --buildExpired            include expired content
-  -F, --buildFuture             include content with publishdate in the future
-      --cacheDir string         filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
-      --canonifyURLs            if true, all relative URLs will be canonicalized using baseURL
-      --cleanDestinationDir     remove files from destination not found in static directories
-  -c, --contentDir string       filesystem path to content directory
-  -d, --destination string      filesystem path to write files to
-      --disable404              do not render 404 page
-      --disableFastRender       enables full re-renders on changes
-      --disableKinds strings    disable different kind of pages (home, RSS etc.)
-      --disableLiveReload       watch without enabling live browser reload on rebuild
-      --disableRSS              do not build RSS files
-      --disableSitemap          do not build Sitemap file
-      --enableGitInfo           add Git revision, date and author info to the pages
-      --forceSyncStatic         copy all files when static is changed.
-  -h, --help                    help for server
-      --i18n-warnings           print missing translations
-      --ignoreCache             ignores the cache directory
-  -l, --layoutDir string        filesystem path to layout directory
-      --liveReloadPort int      port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
-      --meminterval string      interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
-      --memstats string         log memory usage to this file
-      --navigateToChanged       navigate to changed content file on live browser reload
-      --noChmod                 don't sync permission mode of files
-      --noHTTPCache             prevent HTTP caching
-      --noTimes                 don't sync modification time of files
-      --pluralizeListTitles     pluralize titles in lists using inflect (default true)
-  -p, --port int                port on which the server will listen (default 1313)
-      --preserveTaxonomyNames   preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
-      --renderToDisk            render to Destination path (default is render to memory & serve from there)
-  -s, --source string           filesystem path to read files relative from
-      --stepAnalysis            display memory and timing of different steps of the program
-      --templateMetrics         display metrics about template executions
-      --templateMetricsHints    calculate some improvement hints when combined with --templateMetrics
-  -t, --theme string            theme to use (located in /themes/THEMENAME/)
-      --themesDir string        filesystem path to themes directory
-      --uglyURLs                if true, use /filename.html instead of /filename/
-  -w, --watch                   watch filesystem for changes and recreate as needed (default true)
+      --appendPort                 append port to baseURL (default true)
+  -b, --baseURL string             hostname (and path) to the root, e.g. http://spf13.com/
+      --bind string                interface to which the server will bind (default "127.0.0.1")
+  -D, --buildDrafts                include content marked as draft
+  -E, --buildExpired               include expired content
+  -F, --buildFuture                include content with publishdate in the future
+      --cacheDir string            filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+      --canonifyURLs               if true, all relative URLs will be canonicalized using baseURL
+      --cleanDestinationDir        remove files from destination not found in static directories
+  -c, --contentDir string          filesystem path to content directory
+  -d, --destination string         filesystem path to write files to
+      --disable404                 do not render 404 page
+      --disableFastRender          enables full re-renders on changes
+      --disableKinds stringSlice   disable different kind of pages (home, RSS etc.)
+      --disableLiveReload          watch without enabling live browser reload on rebuild
+      --disableRSS                 do not build RSS files
+      --disableSitemap             do not build Sitemap file
+      --enableGitInfo              add Git revision, date and author info to the pages
+      --forceSyncStatic            copy all files when static is changed.
+  -h, --help                       help for server
+      --i18n-warnings              print missing translations
+      --ignoreCache                ignores the cache directory
+  -l, --layoutDir string           filesystem path to layout directory
+      --liveReloadPort int         port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
+      --meminterval string         interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
+      --memstats string            log memory usage to this file
+      --navigateToChanged          navigate to changed content file on live browser reload
+      --noChmod                    don't sync permission mode of files
+      --noHTTPCache                prevent HTTP caching
+      --noTimes                    don't sync modification time of files
+      --pluralizeListTitles        pluralize titles in lists using inflect (default true)
+  -p, --port int                   port on which the server will listen (default 1313)
+      --preserveTaxonomyNames      preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
+      --renderToDisk               render to Destination path (default is render to memory & serve from there)
+  -s, --source string              filesystem path to read files relative from
+      --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
+      --templateMetricsHints       calculate some improvement hints when combined with --templateMetrics
+  -t, --theme string               theme to use (located in /themes/THEMENAME/)
+      --themesDir string           filesystem path to themes directory
+      --uglyURLs                   if true, use /filename.html instead of /filename/
+  -w, --watch                      watch filesystem for changes and recreate as needed (default true)
 ```
 
 ### Options inherited from parent commands
@@ -90,4 +90,4 @@ hugo server [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_undraft.md b/content/commands/hugo_undraft.md
index d324342dc670aee2c51715ba2634bd3e7a577290..e8b67071912c4a60affaafb2f3ad6ef74d70c576 100644 (file)
--- a/content/commands/hugo_undraft.md
+++ b/content/commands/hugo_undraft.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo undraft"
 slug: hugo_undraft
 url: /commands/hugo_undraft/
@@ -40,4 +40,4 @@ hugo undraft path/to/content [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/commands/hugo_version.md b/content/commands/hugo_version.md
index aba0b7b552f5303ed2afcd3d6e3cca9355de1c06..850be51a0df246e6b3f77e4ee33c84c0cbd5e6cb 100644 (file)
--- a/content/commands/hugo_version.md
+++ b/content/commands/hugo_version.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-10-15T10:19:48+02:00
+date: 2017-11-18T10:28:35+01:00
 title: "hugo version"
 slug: hugo_version
 url: /commands/hugo_version/
@@ -38,4 +38,4 @@ hugo version [flags]
 ### SEE ALSO
 * [hugo](/commands/hugo/)       - hugo builds your site
 
-###### Auto generated by spf13/cobra on 15-Oct-2017
+###### Auto generated by spf13/cobra on 18-Nov-2017

diff --git a/content/content-management/multilingual.md b/content/content-management/multilingual.md
index 48bed1bb00701d6768757640f94c9f7598d2b251..4a646741d43a1105310ab0a8d3c20c323ea06a9c 100644 (file)
--- a/content/content-management/multilingual.md
+++ b/content/content-management/multilingual.md
@@ -59,6 +59,52 @@ If you want all of the languages to be put below their respective language code,
 
 Only the obvious non-global options can be overridden per language. Examples of global options are `baseURL`, `buildDrafts`, etc.
 
+## Configure Multilingual Multihost
+
+From **Hugo 0.31** we support multiple languages in a multihost configuration. See [this issue](https://github.com/gohugoio/hugo/issues/4027) for details.
+
+This means that you can now confugre a `baseURL` per `language`:
+
+
+> If a `baseURL` is set on the `language` level, then all languages must have one and they must all be different.
+
+Example:
+
+```bash
+[languages]
+[languages.no]
+baseURL = "https://example.no"
+languageName = "Norsk"
+weight = 1
+title = "På norsk"
+
+[languages.en]
+baseURL = "https://example.com"
+languageName = "English"
+weight = 2
+title = "In English"
+```
+
+With the above, the two sites will be generated into `public` with their own root:
+
+```bash
+public
+├── en
+└── no
+```
+
+**All URLs (i.e `.Permalink` etc.) will be generated from that root. So the English home page above will have its `.Permalink` set to `https://example.com/`.**
+
+When you run `hugo server` we will start multiple HTTP servers. You will typlically see something like this in the console:
+
+```bash
+Web Server is available at 127.0.0.1:1313 (bind address 127.0.0.1)
+Web Server is available at 127.0.0.1:1314 (bind address 127.0.0.1)
+Press Ctrl+C to stop
+```
+
+Live reload and `--navigateToChanged` between the servers work as expected.
+
 ## Taxonomies and Blackfriday
 
 Taxonomies and [Blackfriday configuration][config] can also be set per language:
@@ -102,22 +148,28 @@ In this example, the `about.md` will be assigned the configured `defaultContentL
 
 This way, you can slowly start to translate your current content without having to rename everything. If left unspecified, the default value for `defaultContentLanguage` is `en`.
 
-By having the same *base filename*, the content pieces are linked together as translated pieces.
+By having the same **directory and base filename**, the content pieces are linked together as translated pieces.
 
-If you need distinct URLs per language, you can set the slug in the non-default language file. For example, you can define a custom slug for a French translation in the front matter of `content/about.fr.md` as follows:
+You can also set the key used to link the translations explicitly in front matter:
 
+```yaml
+translationKey: "my-story"
 ```
+
+
+{{% note %}}
+**Before Hugo 0.31**, the file's directory was not considered when looking for translations. This did not work when you named all of your content files, say, `index.md`. Now we use the full content path.
+{{% /note %}}
+
+If you need distinct URLs per language, you can set the slug in the non-default language file. For example, you can define a custom slug for a French translation in the front matter of `content/about.fr.md` as follows:
+
+```yaml
 slug: "a-propos"
 
 ```
 
 At render, Hugo will build both `/about/` and `/a-propos/` as properly linked translated pages.
 
-{{%note %}}
-Hugo currently uses the base filename as the translation key, which can be an issue with identical filenames in different sections.
-We will fix this in https://github.com/gohugoio/hugo/issues/2699
-{{% /note %}}
-{{< todo >}}Rewrite/remove the above one issue is fixed.{{< /todo >}}
 
 ## Link to Translated Content
 
@@ -146,6 +198,13 @@ Hugo uses [go-i18n][] to support string translations. [See the project's source
 
 Translations are collected from the `themes/<THEME>/i18n/` folder (built into the theme), as well as translations present in `i18n/` at the root of your project. In the `i18n`, the translations will be merged and take precedence over what is in the theme folder. Language files should be named according to [RFC 5646][] with names such as `en-US.toml`, `fr.toml`, etc.
 
+{{% note %}}
+From **Hugo 0.31** you no longer need to use a valid language code. It _can be_ anything.
+
+See https://github.com/gohugoio/hugo/issues/3564
+
+{{% /note %}}
+
 From within your templates, use the `i18n` function like this:
 
 ```

diff --git a/content/content-management/static-files.md b/content/content-management/static-files.md
new file mode 100644 (file)
index 0000000..c8ad75d
--- /dev/null
+++ b/content/content-management/static-files.md
@@ -0,0 +1,45 @@
+---
+title: Static Files
+description: "The `static` folder is where you place all your **static files**."
+date: 2017-11-18
+categories: [content management]
+keywords: [source, directories]
+menu:
+  docs:
+    parent: "content-management"
+    weight: 130
+weight: 130    #rem
+aliases: [/static-files]
+toc: true
+---
+
+The `static` folder is where you place all your **static files**, e.g. stylesheets, JavaScript, images etc.
+
+You can set the name of the static folder to use in your configuration file, for example `config.toml`.  From **Hugo 0.31** you can configure as many static directories as you need. All the files in all the static directories will form a union filesystem.
+
+Example:
+
+```toml
+staticDir = ["static1", "static2"]
+[languages]
+[languages.no]
+staticDir = ["staticDir_override", "static_no"]
+baseURL = "https://example.no"
+languageName = "Norsk"
+weight = 1
+title = "På norsk"
+
+[languages.en]
+staticDir2 = "static_en"
+baseURL = "https://example.com"
+languageName = "English"
+weight = 2
+title = "In English"
+```
+
+In the above, with no theme used:
+
+* The English site will get its static files as a union of "static1", "static2" and "static_en". On file duplicates, the right-most version will win.
+* The Norwegian site will get its static files as a union of "staticDir_override" and "static_no".
+
+**Note:** The example above is a [multihost setup](/content-management/multilingual/#configure-multilingual-multihost). In a regular setup, all the static directories will be available to all sites.

diff --git a/content/getting-started/directory-structure.md b/content/getting-started/directory-structure.md
index b5dc9a2ff1f0e48fecd17a4f9c627c28aea51ffb..2403d1812013ccd53e61be600173e7c90831a20b 100644 (file)
--- a/content/getting-started/directory-structure.md
+++ b/content/getting-started/directory-structure.md
@@ -57,9 +57,13 @@ used by Hugo when generating your website. You can write these files in YAML, JS
 [`layouts`][]
 : Stores templates in the form of `.html` files that specify how views of your content will be rendered into a static website. Templates include [list pages][lists], your [homepage][], [taxonomy templates][], [partials][], [single page templates][singles], and more.
 
-`static`
+[`static`][]
 : stores all the static content for your future website: images, CSS, JavaScript, etc. When Hugo builds your site, all assets inside your static directory are copied over as-is. A good example of using the `static` folder is for [verifying site ownership on Google Search Console][searchconsole], where you want Hugo to copy over a complete HTML file without modifying its content.
 
+{{% note %}}
+From **Hugo 0.31** you can have multiple static directories.
+{{% /note %}}
+
 {{% note %}}
 Hugo does not currently ship with an asset pipeline ([#3207](https://github.com/gohugoio/hugo/issues/3207)). You can solicit support from the community in the [Hugo forums](https://discourse.gohugo.io) or check out a few of the [Hugo starter kits](/tools/starter-kits/) for examples of how Hugo developers are managing static assets.
 {{% /note %}}
@@ -73,6 +77,7 @@ Hugo does not currently ship with an asset pipeline ([#3207](https://github.com/
 [data templates]: /templates/data-templates/
 [homepage]: /templates/homepage/
 [`layouts`]: /templates/
+[`static`]: /content-management/static-files/
 [lists]: /templates/list/
 [pagevars]: /variables/page/
 [partials]: /templates/partials/

diff --git a/static/images/blog/hugo-31-poster.png b/static/images/blog/hugo-31-poster.png
new file mode 100644 (file)
index 0000000..e11e53a
Binary files /dev/null and b/static/images/blog/hugo-31-poster.png differ