github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-07 20:30:36 -05:00
Code Issues Projects Releases Packages Wiki Activity

Merge commit 'ecf5e081b5540e69f4af330233f39a07baf53846'

Browse source
This commit is contained in:
Bjørn Erik Pedersen 2017-10-15 10:20:55 +02:00
commit 5c31e0c341
No known key found for this signature in database
GPG key ID: 330E6E2BD4859D8F
46 changed files with 12024 additions and 200 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

82
docs/content/commands/hugo.md
View file

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

71
docs/content/commands/hugo_benchmark.md
View file

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

4
docs/content/commands/hugo_check.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo check" title: "hugo check"
slug: hugo_check slug: hugo_check
url: /commands/hugo_check/ url: /commands/hugo_check/
@ -35,4 +35,4 @@ Contains some verification checks
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
* [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings * [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_check_ulimit.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo check ulimit" title: "hugo check ulimit"
slug: hugo_check_ulimit slug: hugo_check_ulimit
url: /commands/hugo_check_ulimit/ url: /commands/hugo_check_ulimit/
@ -39,4 +39,4 @@ hugo check ulimit [flags]
### SEE ALSO ### SEE ALSO
* [hugo check](/commands/hugo_check/) - Contains some verification checks * [hugo check](/commands/hugo_check/) - Contains some verification checks
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_config.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo config" title: "hugo config"
slug: hugo_config slug: hugo_config
url: /commands/hugo_config/ url: /commands/hugo_config/
@ -38,4 +38,4 @@ hugo config [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_convert.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo convert" title: "hugo convert"
slug: hugo_convert slug: hugo_convert
url: /commands/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 toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML
* [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML * [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_convert_toJSON.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo convert toJSON" title: "hugo convert toJSON"
slug: hugo_convert_toJSON slug: hugo_convert_toJSON
url: /commands/hugo_convert_tojson/ url: /commands/hugo_convert_tojson/
@ -42,4 +42,4 @@ hugo convert toJSON [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_convert_toTOML.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo convert toTOML" title: "hugo convert toTOML"
slug: hugo_convert_toTOML slug: hugo_convert_toTOML
url: /commands/hugo_convert_totoml/ url: /commands/hugo_convert_totoml/
@ -42,4 +42,4 @@ hugo convert toTOML [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_convert_toYAML.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo convert toYAML" title: "hugo convert toYAML"
slug: hugo_convert_toYAML slug: hugo_convert_toYAML
url: /commands/hugo_convert_toyaml/ url: /commands/hugo_convert_toyaml/
@ -42,4 +42,4 @@ hugo convert toYAML [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_env.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo env" title: "hugo env"
slug: hugo_env slug: hugo_env
url: /commands/hugo_env/ url: /commands/hugo_env/
@ -38,4 +38,4 @@ hugo env [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_gen.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo gen" title: "hugo gen"
slug: hugo_gen slug: hugo_gen
url: /commands/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 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 * [hugo gen man](/commands/hugo_gen_man/) - Generate man pages for the Hugo CLI
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_gen_autocomplete.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo gen autocomplete" title: "hugo gen autocomplete"
slug: hugo_gen_autocomplete slug: hugo_gen_autocomplete
url: /commands/hugo_gen_autocomplete/ url: /commands/hugo_gen_autocomplete/
@ -56,4 +56,4 @@ hugo gen autocomplete [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_gen_chromastyles.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo gen chromastyles" title: "hugo gen chromastyles"
slug: hugo_gen_chromastyles slug: hugo_gen_chromastyles
url: /commands/hugo_gen_chromastyles/ url: /commands/hugo_gen_chromastyles/
@ -43,4 +43,4 @@ hugo gen chromastyles [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_gen_doc.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo gen doc" title: "hugo gen doc"
slug: hugo_gen_doc slug: hugo_gen_doc
url: /commands/hugo_gen_doc/ url: /commands/hugo_gen_doc/
@ -45,4 +45,4 @@ hugo gen doc [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_gen_man.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo gen man" title: "hugo gen man"
slug: hugo_gen_man slug: hugo_gen_man
url: /commands/hugo_gen_man/ url: /commands/hugo_gen_man/
@ -41,4 +41,4 @@ hugo gen man [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators.
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_import.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo import" title: "hugo import"
slug: hugo_import slug: hugo_import
url: /commands/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](/commands/hugo/) - hugo builds your site
* [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll * [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_import_jekyll.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo import jekyll" title: "hugo import jekyll"
slug: hugo_import_jekyll slug: hugo_import_jekyll
url: /commands/hugo_import_jekyll/ url: /commands/hugo_import_jekyll/
@ -41,4 +41,4 @@ hugo import jekyll [flags]
### SEE ALSO ### SEE ALSO
* [hugo import](/commands/hugo_import/) - Import your site from others. * [hugo import](/commands/hugo_import/) - Import your site from others.
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_list.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo list" title: "hugo list"
slug: hugo_list slug: hugo_list
url: /commands/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 expired](/commands/hugo_list_expired/) - List all posts already expired
* [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future * [hugo list future](/commands/hugo_list_future/) - List all posts dated in the future
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_list_drafts.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo list drafts" title: "hugo list drafts"
slug: hugo_list_drafts slug: hugo_list_drafts
url: /commands/hugo_list_drafts/ url: /commands/hugo_list_drafts/
@ -39,4 +39,4 @@ hugo list drafts [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [hugo list](/commands/hugo_list/) - Listing out various types of content
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_list_expired.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo list expired" title: "hugo list expired"
slug: hugo_list_expired slug: hugo_list_expired
url: /commands/hugo_list_expired/ url: /commands/hugo_list_expired/
@ -40,4 +40,4 @@ hugo list expired [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [hugo list](/commands/hugo_list/) - Listing out various types of content
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_list_future.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo list future" title: "hugo list future"
slug: hugo_list_future slug: hugo_list_future
url: /commands/hugo_list_future/ url: /commands/hugo_list_future/
@ -40,4 +40,4 @@ hugo list future [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [hugo list](/commands/hugo_list/) - Listing out various types of content
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_new.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo new" title: "hugo new"
slug: hugo_new slug: hugo_new
url: /commands/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 site](/commands/hugo_new_site/) - Create a new site (skeleton)
* [hugo new theme](/commands/hugo_new_theme/) - Create a new theme * [hugo new theme](/commands/hugo_new_theme/) - Create a new theme
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_new_site.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo new site" title: "hugo new site"
slug: hugo_new_site slug: hugo_new_site
url: /commands/hugo_new_site/ url: /commands/hugo_new_site/
@ -43,4 +43,4 @@ hugo new site [path] [flags]
### SEE ALSO ### SEE ALSO
* [hugo new](/commands/hugo_new/) - Create new content for your site * [hugo new](/commands/hugo_new/) - Create new content for your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_new_theme.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo new theme" title: "hugo new theme"
slug: hugo_new_theme slug: hugo_new_theme
url: /commands/hugo_new_theme/ url: /commands/hugo_new_theme/
@ -42,4 +42,4 @@ hugo new theme [name] [flags]
### SEE ALSO ### SEE ALSO
* [hugo new](/commands/hugo_new/) - Create new content for your site * [hugo new](/commands/hugo_new/) - Create new content for your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

86
docs/content/commands/hugo_server.md
View file

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

4
docs/content/commands/hugo_undraft.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo undraft" title: "hugo undraft"
slug: hugo_undraft slug: hugo_undraft
url: /commands/hugo_undraft/ url: /commands/hugo_undraft/
@ -40,4 +40,4 @@ hugo undraft path/to/content [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

4
docs/content/commands/hugo_version.md
View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-26T21:11:49+02:00 date: 2017-10-15T10:19:48+02:00
title: "hugo version" title: "hugo version"
slug: hugo_version slug: hugo_version
url: /commands/hugo_version/ url: /commands/hugo_version/
@ -38,4 +38,4 @@ hugo version [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
###### Auto generated by spf13/cobra on 26-Sep-2017 ###### Auto generated by spf13/cobra on 15-Oct-2017

2
docs/content/content-management/cross-references.md
View file

@ -1,5 +1,5 @@
--- ---
title: Cross References title: Links and Cross References
description: Hugo makes it easy to link documents together. description: Hugo makes it easy to link documents together.
date: 2017-02-01 date: 2017-02-01
publishdate: 2017-02-01 publishdate: 2017-02-01

2
docs/content/content-management/menus.md
View file

@ -18,7 +18,7 @@ toc: true
--- ---
{{% note "Lazy Blogger"%}} {{% note "Lazy Blogger"%}}
If all you want is a simple menu for your sections, see the ["Section Menu for Lazy Bloggers" in Menu Templates](/templates/menu-templates/#section-menu-for-lazy-blogger). If all you want is a simple menu for your sections, see the ["Section Menu for Lazy Bloggers" in Menu Templates](/templates/menu-templates/#section-menu-for-lazy-bloggers).
{{% /note %}} {{% /note %}}
You can do this: You can do this:

8
docs/content/content-management/syntax-highlighting.md
View file

@ -22,21 +22,21 @@ If you want to continue to use Pygments (see below), set `pygmentsUseClassic=tru
The example below shows a simple code snippet from the Hugo source highlighted with the `highlight` shortcode. Note that the gohugo.io site is generated with `pygmentsUseClasses=true` (see [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css)). The example below shows a simple code snippet from the Hugo source highlighted with the `highlight` shortcode. Note that the gohugo.io site is generated with `pygmentsUseClasses=true` (see [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css)).
* `linenos=inline` turns on line numbers. Note that the `inline` value only has an effect in Pygments. * `linenos=inline` or `linenos=table` (`table` will give copy-and-paste friendly code blocks) turns on line numbers.
* `hl_lines` lists a set of line numbers or line number ranges to be highlighted. Note that the hyphen range syntax is only supported for Chroma. * `hl_lines` lists a set of line numbers or line number ranges to be highlighted. Note that the hyphen range syntax is only supported for Chroma.
* `linenostart=199` starts the line number count from 199. * `linenostart=199` starts the line number count from 199.
With that, this: With that, this:
``` ```
{{</* highlight go "linenos=inline,hl_lines=8 15-17,linenostart=199" */>}} {{</* highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" */>}}
// ... code // ... code
{{</* / highlight */>}} {{</* / highlight */>}}
``` ```
Gives this: Gives this:
{{< highlight go "linenos=inline,hl_lines=8 15-17,linenostart=199" >}} {{< highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" >}}
// GetTitleFunc returns a func that can be used to transform a string to // GetTitleFunc returns a func that can be used to transform a string to
// title case. // title case.
// //
@ -106,7 +106,7 @@ The full set of supported options for Pygments is: `encoding`, `outencoding`, `n
## Generate Syntax Highlighter CSS ## Generate Syntax Highlighter CSS
If you run with `pygmentsUseClassic=true` in your site config, you need a style sheet. If you run with `pygmentsUseClasses=true` in your site config, you need a style sheet.
You can generate one with Hugo: You can generate one with Hugo:

4
docs/content/content-management/toc.md
View file

@ -45,6 +45,10 @@ Hugo will take this Markdown and create a table of contents from `## Introductio
The built-in `.TableOfContents` variables outputs a `<nav id="TableOfContents">` element with a child `<ul>`, whose child `<li>` elements begin with any `<h1>`'s (i.e., `#` in markdown) inside your content.' The built-in `.TableOfContents` variables outputs a `<nav id="TableOfContents">` element with a child `<ul>`, whose child `<li>` elements begin with any `<h1>`'s (i.e., `#` in markdown) inside your content.'
{{% note "Table of contents not available for MMark" %}}
Hugo documents created in the [MMark](/content-management/formats/#mmark) Markdown dialect do not currently display TOCs. TOCs are, however, compatible with all other supported Markdown formats.
{{% /note %}}
## Template Example: Basic TOC ## Template Example: Basic TOC
The following is an example of a very basic [single page template][]: The following is an example of a very basic [single page template][]:

6
docs/content/functions/ref.md
View file

@ -11,7 +11,7 @@ menu:
docs: docs:
parent: "functions" parent: "functions"
keywords: [cross references, anchors] keywords: [cross references, anchors]
signature: ["ref PAGE CONTENT"] signature: ["ref CONTENT"]
workson: [] workson: []
hugoversion: hugoversion:
relatedfuncs: [relref] relatedfuncs: [relref]
@ -19,10 +19,10 @@ deprecated: false
aliases: [] aliases: []
--- ---
`ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink. Both functions require a `Page` object (usually satisfied with a "`.`"): `ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink:
``` ```
{{ relref . "about.md" }} {{ ref "about.md" }}
``` ```
These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref). These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref).

6
docs/content/functions/relref.md
View file

@ -11,7 +11,7 @@ menu:
docs: docs:
parent: "functions" parent: "functions"
keywords: [cross references, anchors] keywords: [cross references, anchors]
signature: ["relref PAGE CONTENT"] signature: ["relref CONTENT"]
workson: [] workson: []
hugoversion: hugoversion:
relatedfuncs: [relref] relatedfuncs: [relref]
@ -19,10 +19,10 @@ deprecated: false
aliases: [] aliases: []
--- ---
`ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink. Both functions require a `Page` object (usually satisfied with a "`.`"): `ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink:
``` ```
{{ relref . "about.md" }} {{ relref "about.md" }}
``` ```
These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref). These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref).

19
docs/content/getting-started/configuration.md
View file

@ -34,10 +34,9 @@ In your `config` file, you can direct Hugo as to how you want your website rende
## YAML Configuration ## YAML Configuration
The following is a typical example of a YAML configuration file. Note the document opens with 3 hyphens and closes with 3 periods. The values nested under `params:` will populate the [`.Site.Params`][] variable for use in [templates][]: The following is a typical example of a YAML configuration file. The values nested under `params:` will populate the [`.Site.Params`][] variable for use in [templates][]:
{{< code file="config.yml">}} {{< code file="config.yml">}}
---
baseURL: "https://yoursite.example.com/" baseURL: "https://yoursite.example.com/"
title: "My Hugo Site" title: "My Hugo Site"
footnoteReturnLinkContents: "↩" footnoteReturnLinkContents: "↩"
@ -51,7 +50,6 @@ params:
- "foo1" - "foo1"
- "foo2" - "foo2"
SidebarRecentLimit: 5 SidebarRecentLimit: 5
...
{{< /code >}} {{< /code >}}
### All Variables, YAML ### All Variables, YAML
@ -59,7 +57,6 @@ params:
The following is the full list of Hugo-defined variables in an example YAML file. The values provided in this example represent the default values used by Hugo. The following is the full list of Hugo-defined variables in an example YAML file. The values provided in this example represent the default values used by Hugo.
{{< code file="config.yml" download="config.yml" >}} {{< code file="config.yml" download="config.yml" >}}
---
archetypeDir: "archetypes" archetypeDir: "archetypes"
# hostname (and path) to the root, e.g. http://spf13.com/ # hostname (and path) to the root, e.g. http://spf13.com/
baseURL: "" baseURL: ""
@ -174,14 +171,13 @@ watch: true
taxonomies: taxonomies:
- category: "categories" - category: "categories"
- tag: "tags" - tag: "tags"
---
{{< /code >}} {{< /code >}}
## TOML Configuration ## TOML Configuration
The following is an example of a TOML configuration file. The values under `[params]` will populate the `.Site.Params` variable for use in [templates][]: The following is an example of a TOML configuration file. The values under `[params]` will populate the `.Site.Params` variable for use in [templates][]:
``` {{< code file="config.toml">}}
contentDir = "content" contentDir = "content"
layoutDir = "layouts" layoutDir = "layouts"
publishDir = "public" publishDir = "public"
@ -197,14 +193,13 @@ title = "My Hugo Site"
[params] [params]
subtitle = "Hugo is Absurdly Fast!" subtitle = "Hugo is Absurdly Fast!"
author = "John Doe" author = "John Doe"
``` {{< /code >}}
### All Variables, TOML ### All Variables, TOML
The following is the full list of Hugo-defined variables in an example TOML file. The values provided in this example represent the default values used by Hugo. The following is the full list of Hugo-defined variables in an example TOML file. The values provided in this example represent the default values used by Hugo.
{{< code file="config.toml" download="config.toml">}} {{< code file="config.toml" download="config.toml">}}
+++
archetypeDir = "archetypes" archetypeDir = "archetypes"
# hostname (and path) to the root, e.g. http://spf13.com/ # hostname (and path) to the root, e.g. http://spf13.com/
baseURL = "" baseURL = ""
@ -313,14 +308,18 @@ watch = true
[taxonomies] [taxonomies]
category = "categories" category = "categories"
tag = "tags" tag = "tags"
+++
{{< /code >}} {{< /code >}}
{{% note %}} {{% note %}}
If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line: If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line:
``` ```
~/sites/yourhugosite cd ~/sites/yourhugosite
hugo config | grep emoji hugo config | grep emoji
```
which shows output like
```
enableemoji: true enableemoji: true
``` ```
{{% /note %}} {{% /note %}}

2
docs/content/templates/robots.md
View file

@ -29,7 +29,7 @@ User-agent: *
The [lookup order][lookup] for the `robots.txt` template is as follows: The [lookup order][lookup] for the `robots.txt` template is as follows:
* `/layouts/robots.txt` * `/layouts/robots.txt`
* `/themes/<THEME>/layout/robots.txt` * `/themes/<THEME>/layouts/robots.txt`
{{% note %}} {{% note %}}
If you do not want Hugo to create a default `robots.txt` or leverage the `robots.txt` template, you can hand code your own and place the file in `static`. Remember that everything in the [static directory](/getting-started/directory-structure/) is copied over as-is when Hugo builds your site. If you do not want Hugo to create a default `robots.txt` or leverage the `robots.txt` template, you can hand code your own and place the file in `static`. Remember that everything in the [static directory](/getting-started/directory-structure/) is copied over as-is when Hugo builds your site.

2
docs/content/tools/starter-kits.md
View file

@ -27,6 +27,7 @@ The following starter kits are developed by active members of the Hugo community
* [GOHUGO AMP][]. GoHugo AMP is a starter theme that aims to make it easy to adopt [Google's AMP Project][amp]. The starter kit comes with 40+ shortcodes and partials plus automatic structured data. The project also includes a [separate site with extensive documentation][gohugodocs]. * [GOHUGO AMP][]. GoHugo AMP is a starter theme that aims to make it easy to adopt [Google's AMP Project][amp]. The starter kit comes with 40+ shortcodes and partials plus automatic structured data. The project also includes a [separate site with extensive documentation][gohugodocs].
* [Blaupause][]. Blaupause is a developer-friendly Hugo starter kit based on Gulp tasks. It comes ES6-ready with several helpers for SVG and fonts and basic structure for HTML, SCSS, and JavaScript. * [Blaupause][]. Blaupause is a developer-friendly Hugo starter kit based on Gulp tasks. It comes ES6-ready with several helpers for SVG and fonts and basic structure for HTML, SCSS, and JavaScript.
* [hugulp][]. hugulp is a tool to optimize the assets of a Hugo website. The main idea is to recreate the famous Ruby on Rails Asset Pipeline, which minifies, concatenates and fingerprints the assets used in your website. * [hugulp][]. hugulp is a tool to optimize the assets of a Hugo website. The main idea is to recreate the famous Ruby on Rails Asset Pipeline, which minifies, concatenates and fingerprints the assets used in your website.
* [Atlas][]. Atlas is a Hugo boilerplate designed to speed up development with support for Netlify, Netlify CMS, Gulp, Linting, SCSS, ES6 & more. It's actively maintained and contributions are always welcome.
[addkit]: https://github.com/gohugoio/hugo/edit/master/docs/content/tools/starter-kits.md [addkit]: https://github.com/gohugoio/hugo/edit/master/docs/content/tools/starter-kits.md
@ -36,3 +37,4 @@ The following starter kits are developed by active members of the Hugo community
[gohugodocs]: https://gohugo-amp.gohugohq.com/ [gohugodocs]: https://gohugo-amp.gohugohq.com/
[hugulp]: https://github.com/jbrodriguez/hugulp [hugulp]: https://github.com/jbrodriguez/hugulp
[Victor Hugo]: https://github.com/netlify/victor-hugo [Victor Hugo]: https://github.com/netlify/victor-hugo
[Atlas]: https://github.com/indigotree/atlas

4
docs/content/variables/git.md
View file

@ -51,4 +51,8 @@ The `GitInfo` object contains the following fields:
`.Subject` `.Subject`
: commit message subject (e.g., `tpl: Add custom index function`) : commit message subject (e.g., `tpl: Add custom index function`)
## `.Lastmod`
If the `.GitInfo` feature is enabled, **and** if the `lastmod` field in the content's front matter is not set, `.Lastmod` (on `Page`) is fetched from Git i.e. `.GitInfo.AuthorDate`.
[configuration]: /getting-started/configuration/ [configuration]: /getting-started/configuration/

9
docs/content/variables/page.md
View file

@ -79,7 +79,12 @@ See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
`config`. `config`.
`.Lastmod` `.Lastmod`
: the date the content was last modified; `.Lastmod` pulls from the `lastmod` field in a content's front matter. If `lastmod` is not set, Hugo will default to the `date` field. See also `.ExpiryDate`, `.Date`, and `.PublishDate`. : the date the content was last modified. `.Lastmod` pulls from the `lastmod` field in a content's front matter.
- If `lastmod` is not set, and `.GitInfo` feature is disabled, the front matter `date` field will be used.
- If `lastmod` is not set, and `.GitInfo` feature is enabled, `.GitInfo.AuthorDate` will be used instead.
See also `.ExpiryDate`, `.Date`, `.PublishDate`, and [`.GitInfo`][gitinfo].
`.LinkTitle` `.LinkTitle`
: access when creating links to the content. If set, Hugo will use the `linktitle` from the front matter before `title`. : access when creating links to the content. If set, Hugo will use the `linktitle` from the front matter before `title`.
@ -266,3 +271,5 @@ The top-level key will be preferred. Therefore, the following method, when appli
{{ $.Param "favorites.flavor" }} {{ $.Param "favorites.flavor" }}
=> vanilla => vanilla
``` ```
[gitinfo]: /variables/git/

105
docs/data/docs.json
View file

@ -352,6 +352,21 @@
"tpl": { "tpl": {
"funcs": { "funcs": {
"cast": { "cast": {
"ToFloat": {
"Description": "ToFloat converts the given value to a float.",
"Args": [
"v"
],
"Aliases": [
"float"
],
"Examples": [
[
"{{ \"1234\" | float | printf \"%T\" }}",
"float64"
]
]
},
"ToInt": { "ToInt": {
"Description": "ToInt converts the given value to an int.", "Description": "ToInt converts the given value to an int.",
"Args": [ "Args": [
@ -888,6 +903,22 @@
} }
}, },
"fmt": { "fmt": {
"Errorf": {
"Description": "",
"Args": [
"format",
"a"
],
"Aliases": [
"errorf"
],
"Examples": [
[
"{{ errorf \"%s.\" \"failed\" }}",
"failed."
]
]
},
"Print": { "Print": {
"Description": "Print returns string representation of the passed arguments.", "Description": "Print returns string representation of the passed arguments.",
"Args": [ "Args": [
@ -920,7 +951,7 @@
] ]
}, },
"Println": { "Println": {
"Description": "Print returns string representation of the passed arguments ending with a newline.", "Description": "Println returns string representation of the passed arguments ending with a newline.",
"Args": [ "Args": [
"a" "a"
], ],
@ -1068,6 +1099,19 @@
] ]
] ]
}, },
"Ceil": {
"Description": "Ceil returns the least integer value greater than or equal to x.",
"Args": [
"x"
],
"Aliases": null,
"Examples": [
[
"{{math.Ceil 2.1}}",
"3"
]
]
},
"Div": { "Div": {
"Description": "Div divides two numbers.", "Description": "Div divides two numbers.",
"Args": [ "Args": [
@ -1084,6 +1128,19 @@
] ]
] ]
}, },
"Floor": {
"Description": "Floor returns the greatest integer value less than or equal to x.",
"Args": [
"x"
],
"Aliases": null,
"Examples": [
[
"{{math.Floor 1.9}}",
"1"
]
]
},
"Log": { "Log": {
"Description": "Log returns the natural logarithm of a number.", "Description": "Log returns the natural logarithm of a number.",
"Args": [ "Args": [
@ -1145,6 +1202,19 @@
] ]
] ]
}, },
"Round": {
"Description": "Round returns the nearest integer, rounding half away from zero.",
"Args": [
"x"
],
"Aliases": null,
"Examples": [
[
"{{math.Round 1.5}}",
"2"
]
]
},
"Sub": { "Sub": {
"Description": "Sub subtracts two numbers.", "Description": "Sub subtracts two numbers.",
"Args": [ "Args": [
@ -1163,6 +1233,21 @@
} }
}, },
"os": { "os": {
"FileExists": {
"Description": "FileExists checks whether a file exists under the given path.",
"Args": [
"i"
],
"Aliases": [
"fileExists"
],
"Examples": [
[
"{{ fileExists \"foo.txt\" }}",
"false"
]
]
},
"Getenv": { "Getenv": {
"Description": "Getenv retrieves the value of the environment variable named by the key.\nIt returns the value, which will be empty if the variable is not present.", "Description": "Getenv retrieves the value of the environment variable named by the key.\nIt returns the value, which will be empty if the variable is not present.",
"Args": [ "Args": [
@ -1220,6 +1305,18 @@
"\u003ctitle\u003eHugo Rocks!\u003c/title\u003e" "\u003ctitle\u003eHugo Rocks!\u003c/title\u003e"
] ]
] ]
},
"IncludeCached": {
"Description": "IncludeCached executes and caches partial templates. An optional variant\nstring parameter (a string slice actually, but be only use a variadic\nargument to make it optional) can be passed so that a given partial can have\nmultiple uses. The cache is created with name+variant as the key.",
"Args": [
"name",
"context",
"variant"
],
"Aliases": [
"partialCached"
],
"Examples": []
} }
}, },
"safe": { "safe": {
@ -1838,6 +1935,12 @@
], ],
"Examples": [] "Examples": []
}, },
"Parse": {
"Description": "",
"Args": null,
"Aliases": null,
"Examples": null
},
"Ref": { "Ref": {
"Description": "Ref returns the absolute URL path to a given content item.", "Description": "Ref returns the absolute URL path to a given content item.",
"Args": [ "Args": [

BIN
docs/static/images/blog/hugo-30-poster.png vendored Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 120 KiB

2
docs/themes/gohugoioTheme/layouts/_default/baseof.html vendored
View file

@ -44,7 +44,7 @@
{{ block "main" . }}{{ end }} {{ block "main" . }}{{ end }}
</main> </main>
{{ block "footer" . }}{{ partial "site-footer.html" . }}{{ end }} {{ block "footer" . }}{{ partialCached "site-footer.html" . }}{{ end }}
{{ block "scripts" . }}{{- partial "site-scripts.html" . -}}{{ end }} {{ block "scripts" . }}{{- partial "site-scripts.html" . -}}{{ end }}
</body> </body>

2
docs/themes/gohugoioTheme/layouts/partials/site-nav.html vendored
View file

@ -29,7 +29,7 @@
</div> </div>
<span class="absolute mt1 mt2-l pr3 right-0 top-0"> <span class="absolute mt1 mt2-l pr3 right-0 top-0">
{{- partial "social-follow.html" . -}} {{- partialCached "social-follow.html" . -}}
</span> </span>
</div> </div>

3
docs/themes/gohugoioTheme/src/css/_chroma2.css vendored
View file

@ -1,6 +1,9 @@
/* Background */ .chroma { background-color: #f0f0f0 } /* Background */ .chroma { background-color: #f0f0f0 }
/* Error */ .chroma .err { } /* Error */ .chroma .err { }
/* LineTableTD */ .chroma .lntd { ; vertical-align: top; padding: 0; margin: 0; border: 0; }
/* LineTable */ .chroma .lntable { ; border-spacing: 0; padding: 0; margin: 0; border: 0; width: 100%; overflow: auto; display: block; }
/* LineHighlight */ .chroma .hl { background-color: #ffffcc; display: block; width: 100% } /* LineHighlight */ .chroma .hl { background-color: #ffffcc; display: block; width: 100% }
/* LineNumbersTable */ .chroma .lnt { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; display: block; }
/* LineNumbers */ .chroma .ln { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; } /* LineNumbers */ .chroma .ln { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; }
/* Keyword */ .chroma .k { color: #007020; font-weight: bold } /* Keyword */ .chroma .k { color: #007020; font-weight: bold }
/* KeywordConstant */ .chroma .kc { color: #007020; font-weight: bold } /* KeywordConstant */ .chroma .kc { color: #007020; font-weight: bold }

11
docs/themes/gohugoioTheme/src/css/_code.css vendored
View file

@ -1,3 +1,14 @@
.chroma .lntable pre {
padding: 0;
margin: 0;
border: 0;
}
.chroma .lntable pre code {
padding: 0;
margin: 0;
}
pre, .pre { pre, .pre {
overflow-x: auto; overflow-x: auto;
overflow-y: hidden; overflow-y: hidden;

11696
docs/themes/gohugoioTheme/static/dist/app.bundle.js vendored
View file

File diff suppressed because one or more lines are too long

2
docs/themes/gohugoioTheme/static/dist/main.css vendored
View file

File diff suppressed because one or more lines are too long