From 14e369b961943a0b977776899e24e8bea63834df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Mon, 9 Mar 2020 20:19:32 +0100 Subject: Squashed 'docs/' changes from 341ecabb2..988f7d5c2 988f7d5c2 Document default `enableInlineShortcodes` value 0f604a345 Fix typo in 0.66.0 release note 26fc74fe3 How to access individual EXIF data tags d5d3bad9a Fix localhost links fa6921213 Update index.md 5bf558f78 Release 0.66.0 74ccdaaf5 Merge branch 'temp660' 75faa478b releaser: Add release notes to /docs for release of 0.66.0 c4a4a9922 docs: Regen CLI docs 0624ac198 Add build.UseResourceCacheWhen 58a8d7cd1 Add build options documentation d926c595e fix typo 99713d44b resources: Add basic @import support to resources.PostCSS 224b96cf7 deploy: Implement include/exclude filters for deploy eb1a00050 Adjusting description; WordPress with capitalized P 91d8efa22 Add another tool for migration from the Wordpress a6938a4ac Adjust showcase description a9c0a0a69 Adjust showcase e5af08aa6 Adding Aether as a proposed showcase item. 0013daa34 Add hugo.IsProduction function 34c419ef3 tpl: Add math.Sqrt 5bdab0ebd Update minification.md 9039332e2 Hugo 0.65.3 1400caf3a Merge branch 'temp653' 9796bb337 releaser: Add release notes to /docs for release of 0.65.3 65b26598f Fix typo 23aa57d80 Fix crashes for 404 in IsAncestor etc. 42c54bc6c 0.65.2 67fd5c1f6 Merge branch 'temp652' d820ac017 releaser: Add release notes to /docs for release of 0.65.2 51f0888ff Release 0.65.1 91e95260c releaser: Add release notes to /docs for release of 0.65.1 1880ebf05 fix broken link on internal.md ffaa33889 Update migrations.md de4d64675 Another tool for migration from Medium platform 90b178d77 releaser: Add release notes to /docs for release of 0.65.1 6925cda30 Handle corner case with rendering text as code in URL 3cb4b19dd Release 0.65.0 7a600cb99 Merge branch 'temp650' ef9531ff6 releaser: Add release notes to /docs for release of 0.65.0 9bc19606f docs: Regenerate CLI docs d4a886ed2 Add Page.GetTerms a3bf273a5 fix broken link on use-modules.md 001f52f4e Fix mage URL in development.md eef72e887 Merge commit '4b670bc8cc38103c2c60e5090c2f56bf30832b8d' b18a76631 commands: Support "hugo mod get -u ./..." git-subtree-dir: docs git-subtree-split: 988f7d5c2d7a1d40ec2c8ab961cb5a4e41b5bd4c --- content/en/commands/hugo.md | 8 +- content/en/commands/hugo_check.md | 4 +- content/en/commands/hugo_check_ulimit.md | 4 +- content/en/commands/hugo_config.md | 4 +- content/en/commands/hugo_config_mounts.md | 4 +- content/en/commands/hugo_convert.md | 4 +- content/en/commands/hugo_convert_toJSON.md | 4 +- content/en/commands/hugo_convert_toTOML.md | 4 +- content/en/commands/hugo_convert_toYAML.md | 4 +- content/en/commands/hugo_deploy.md | 6 +- content/en/commands/hugo_env.md | 4 +- content/en/commands/hugo_gen.md | 4 +- content/en/commands/hugo_gen_autocomplete.md | 4 +- content/en/commands/hugo_gen_chromastyles.md | 4 +- content/en/commands/hugo_gen_doc.md | 6 +- content/en/commands/hugo_gen_man.md | 4 +- content/en/commands/hugo_import.md | 4 +- content/en/commands/hugo_import_jekyll.md | 4 +- content/en/commands/hugo_list.md | 4 +- content/en/commands/hugo_list_all.md | 4 +- content/en/commands/hugo_list_drafts.md | 4 +- content/en/commands/hugo_list_expired.md | 4 +- content/en/commands/hugo_list_future.md | 4 +- content/en/commands/hugo_mod.md | 9 +- content/en/commands/hugo_mod_clean.md | 12 +- content/en/commands/hugo_mod_get.md | 5 +- content/en/commands/hugo_mod_graph.md | 4 +- content/en/commands/hugo_mod_init.md | 4 +- content/en/commands/hugo_mod_tidy.md | 4 +- content/en/commands/hugo_mod_vendor.md | 4 +- content/en/commands/hugo_mod_verify.md | 48 +++++++ content/en/commands/hugo_new.md | 6 +- content/en/commands/hugo_new_site.md | 4 +- content/en/commands/hugo_new_theme.md | 4 +- content/en/commands/hugo_server.md | 6 +- content/en/commands/hugo_version.md | 4 +- content/en/content-management/build-options.md | 94 ++++++++++++++ .../content-management/image-processing/index.md | 11 ++ content/en/content-management/shortcodes.md | 2 +- content/en/contribute/development.md | 2 +- content/en/functions/hugo.md | 5 +- content/en/functions/math.md | 5 +- content/en/getting-started/configuration-markup.md | 2 +- content/en/getting-started/configuration.md | 20 ++- content/en/hosting-and-deployment/hugo-deploy.md | 9 +- content/en/hugo-modules/use-modules.md | 11 +- content/en/hugo-pipes/minification.md | 4 +- content/en/hugo-pipes/postcss.md | 23 ++++ .../0.65.0-relnotes/hugo-65-poster-featured.png | Bin 0 -> 115945 bytes content/en/news/0.65.0-relnotes/index.md | 141 +++++++++++++++++++++ content/en/news/0.65.0-relnotes/pg-admin-tos.png | Bin 0 -> 65614 bytes content/en/news/0.65.1-relnotes/index.md | 20 +++ content/en/news/0.65.2-relnotes/index.md | 21 +++ content/en/news/0.65.3-relnotes/index.md | 21 +++ .../0.66.0-relnotes/hugo-66-poster-featured.png | Bin 0 -> 75588 bytes content/en/news/0.66.0-relnotes/index.md | 81 ++++++++++++ content/en/readfiles/sectionvars.md | 6 +- content/en/showcase/aether/bio.md | 9 ++ content/en/showcase/aether/featured.png | Bin 0 -> 275219 bytes content/en/showcase/aether/index.md | 39 ++++++ content/en/templates/internal.md | 2 +- content/en/templates/output-formats.md | 2 +- content/en/templates/taxonomy-templates.md | 12 ++ content/en/tools/migrations.md | 2 + netlify.toml | 8 +- ...7adcedfd7f7_77631_640x0_resize_catmullrom_2.png | Bin 57252 -> 0 bytes ...e824a391758_66863_640x0_resize_catmullrom_2.png | Bin 47821 -> 0 bytes ...1c9409185d8_68614_640x0_resize_catmullrom_2.png | Bin 49480 -> 0 bytes ...d1416f654ff_88288_640x0_resize_catmullrom_2.png | Bin 61347 -> 0 bytes ...8c38dbf3fd_115945_480x0_resize_catmullrom_2.png | Bin 0 -> 39995 bytes ...8c38dbf3fd_115945_640x0_resize_catmullrom_2.png | Bin 0 -> 68029 bytes ...3723d4914a5_75588_480x0_resize_catmullrom_2.png | Bin 0 -> 29574 bytes ...3723d4914a5_75588_640x0_resize_catmullrom_2.png | Bin 0 -> 48654 bytes ...dd374_275219_1024x512_fill_catmullrom_top_2.png | Bin 0 -> 148893 bytes ...3535cdd374_275219_640x0_resize_catmullrom_2.png | Bin 0 -> 68479 bytes ...374_275219_989c7e76c2c712f873e3f3bc40d31e81.png | Bin 0 -> 49261 bytes ...0b7cf78050_451984_640x0_resize_catmullrom_2.png | Bin 113846 -> 0 bytes 77 files changed, 665 insertions(+), 101 deletions(-) create mode 100644 content/en/commands/hugo_mod_verify.md create mode 100644 content/en/content-management/build-options.md create mode 100644 content/en/news/0.65.0-relnotes/hugo-65-poster-featured.png create mode 100644 content/en/news/0.65.0-relnotes/index.md create mode 100644 content/en/news/0.65.0-relnotes/pg-admin-tos.png create mode 100644 content/en/news/0.65.1-relnotes/index.md create mode 100644 content/en/news/0.65.2-relnotes/index.md create mode 100644 content/en/news/0.65.3-relnotes/index.md create mode 100644 content/en/news/0.66.0-relnotes/hugo-66-poster-featured.png create mode 100644 content/en/news/0.66.0-relnotes/index.md create mode 100644 content/en/showcase/aether/bio.md create mode 100644 content/en/showcase/aether/featured.png create mode 100644 content/en/showcase/aether/index.md delete mode 100644 resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.45-relnotes/featured-hugo-45-poster_huea79995576e3b93a3041ae824a391758_66863_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.46-relnotes/featured-hugo-46-poster_hue04c7655caa254a1835311c9409185d8_68614_640x0_resize_catmullrom_2.png delete mode 100644 resources/_gen/images/news/0.47-relnotes/featured-hugo-47-poster_hud3879b84908b49d38ac2cd1416f654ff_88288_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.65.0-relnotes/hugo-65-poster-featured_hu2a74c431783b3f7931799f8c38dbf3fd_115945_480x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.65.0-relnotes/hugo-65-poster-featured_hu2a74c431783b3f7931799f8c38dbf3fd_115945_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.66.0-relnotes/hugo-66-poster-featured_hu4d3a62a6d2ad42dd03e2a3723d4914a5_75588_480x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/news/0.66.0-relnotes/hugo-66-poster-featured_hu4d3a62a6d2ad42dd03e2a3723d4914a5_75588_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/showcase/Aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_1024x512_fill_catmullrom_top_2.png create mode 100644 resources/_gen/images/showcase/Aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_640x0_resize_catmullrom_2.png create mode 100644 resources/_gen/images/showcase/Aether/featured_hu087b0e6f87446792599d3d3535cdd374_275219_989c7e76c2c712f873e3f3bc40d31e81.png delete mode 100644 resources/_gen/images/showcase/arolla-cocoon/featured-template_hu22aab819ab27e4f878d1ff0b7cf78050_451984_640x0_resize_catmullrom_2.png diff --git a/content/en/commands/hugo.md b/content/en/commands/hugo.md index a802271bd..fe519d397 100644 --- a/content/en/commands/hugo.md +++ b/content/en/commands/hugo.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo" slug: hugo url: /commands/hugo/ @@ -15,7 +15,7 @@ hugo is the main command, used to build your Hugo site. Hugo is a Fast and Flexible Static Site Generator built with love by spf13 and friends in Go. -Complete documentation is available at https://gohugo.io/. +Complete documentation is available at http://gohugo.io/. ``` hugo [flags] @@ -24,7 +24,7 @@ hugo [flags] ### Options ``` - -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/ + -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 @@ -79,4 +79,4 @@ hugo [flags] * [hugo server](/commands/hugo_server/) - A high performance webserver * [hugo version](/commands/hugo_version/) - Print the version number of Hugo -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_check.md b/content/en/commands/hugo_check.md index fc727476a..7c515e48d 100644 --- a/content/en/commands/hugo_check.md +++ b/content/en/commands/hugo_check.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo check" slug: hugo_check url: /commands/hugo_check/ @@ -40,4 +40,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_check_ulimit.md b/content/en/commands/hugo_check_ulimit.md index 478c9a850..fec6f7a37 100644 --- a/content/en/commands/hugo_check_ulimit.md +++ b/content/en/commands/hugo_check_ulimit.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo check ulimit" slug: hugo_check_ulimit url: /commands/hugo_check_ulimit/ @@ -44,4 +44,4 @@ hugo check ulimit [flags] * [hugo check](/commands/hugo_check/) - Contains some verification checks -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_config.md b/content/en/commands/hugo_config.md index 6e1094903..40b947851 100644 --- a/content/en/commands/hugo_config.md +++ b/content/en/commands/hugo_config.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo config" slug: hugo_config url: /commands/hugo_config/ @@ -44,4 +44,4 @@ hugo config [flags] * [hugo](/commands/hugo/) - hugo builds your site * [hugo config mounts](/commands/hugo_config_mounts/) - Print the configured file mounts -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_config_mounts.md b/content/en/commands/hugo_config_mounts.md index 98cd6f9eb..c2de54812 100644 --- a/content/en/commands/hugo_config_mounts.md +++ b/content/en/commands/hugo_config_mounts.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo config mounts" slug: hugo_config_mounts url: /commands/hugo_config_mounts/ @@ -43,4 +43,4 @@ hugo config mounts [flags] * [hugo config](/commands/hugo_config/) - Print the site configuration -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_convert.md b/content/en/commands/hugo_convert.md index 1e85b72f1..47132c573 100644 --- a/content/en/commands/hugo_convert.md +++ b/content/en/commands/hugo_convert.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo convert" slug: hugo_convert url: /commands/hugo_convert/ @@ -46,4 +46,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_convert_toJSON.md b/content/en/commands/hugo_convert_toJSON.md index 484d942e6..df46d01d5 100644 --- a/content/en/commands/hugo_convert_toJSON.md +++ b/content/en/commands/hugo_convert_toJSON.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo convert toJSON" slug: hugo_convert_toJSON url: /commands/hugo_convert_tojson/ @@ -46,4 +46,4 @@ hugo convert toJSON [flags] * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_convert_toTOML.md b/content/en/commands/hugo_convert_toTOML.md index 53f25cf66..dd80cb7a5 100644 --- a/content/en/commands/hugo_convert_toTOML.md +++ b/content/en/commands/hugo_convert_toTOML.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo convert toTOML" slug: hugo_convert_toTOML url: /commands/hugo_convert_totoml/ @@ -46,4 +46,4 @@ hugo convert toTOML [flags] * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_convert_toYAML.md b/content/en/commands/hugo_convert_toYAML.md index 4173883d8..9397aee34 100644 --- a/content/en/commands/hugo_convert_toYAML.md +++ b/content/en/commands/hugo_convert_toYAML.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo convert toYAML" slug: hugo_convert_toYAML url: /commands/hugo_convert_toyaml/ @@ -46,4 +46,4 @@ hugo convert toYAML [flags] * [hugo convert](/commands/hugo_convert/) - Convert your content to different formats -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_deploy.md b/content/en/commands/hugo_deploy.md index 054a16d42..ed208fc68 100644 --- a/content/en/commands/hugo_deploy.md +++ b/content/en/commands/hugo_deploy.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo deploy" slug: hugo_deploy url: /commands/hugo_deploy/ @@ -27,7 +27,7 @@ hugo deploy [flags] --dryRun dry run --force force upload of all files -h, --help help for deploy - --invalidateCDN invalidate the CDN cache via the cloudFrontDistributionID listed in the deployment target (default true) + --invalidateCDN invalidate the CDN cache listed in the deployment target (default true) --maxDeletes int maximum # of files to delete, or -1 to disable (default 256) --target string target deployment from deployments section in config file; defaults to the first one ``` @@ -53,4 +53,4 @@ hugo deploy [flags] * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_env.md b/content/en/commands/hugo_env.md index 5d134d693..1344f495d 100644 --- a/content/en/commands/hugo_env.md +++ b/content/en/commands/hugo_env.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo env" slug: hugo_env url: /commands/hugo_env/ @@ -43,4 +43,4 @@ hugo env [flags] * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_gen.md b/content/en/commands/hugo_gen.md index e195882de..44ca1a12e 100644 --- a/content/en/commands/hugo_gen.md +++ b/content/en/commands/hugo_gen.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo gen" slug: hugo_gen url: /commands/hugo_gen/ @@ -43,4 +43,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_gen_autocomplete.md b/content/en/commands/hugo_gen_autocomplete.md index 0c4657a87..f0e82ede1 100644 --- a/content/en/commands/hugo_gen_autocomplete.md +++ b/content/en/commands/hugo_gen_autocomplete.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo gen autocomplete" slug: hugo_gen_autocomplete url: /commands/hugo_gen_autocomplete/ @@ -61,4 +61,4 @@ hugo gen autocomplete [flags] * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_gen_chromastyles.md b/content/en/commands/hugo_gen_chromastyles.md index c893a7f33..198fe1db6 100644 --- a/content/en/commands/hugo_gen_chromastyles.md +++ b/content/en/commands/hugo_gen_chromastyles.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo gen chromastyles" slug: hugo_gen_chromastyles url: /commands/hugo_gen_chromastyles/ @@ -48,4 +48,4 @@ hugo gen chromastyles [flags] * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_gen_doc.md b/content/en/commands/hugo_gen_doc.md index cda495090..2c003a972 100644 --- a/content/en/commands/hugo_gen_doc.md +++ b/content/en/commands/hugo_gen_doc.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo gen doc" slug: hugo_gen_doc url: /commands/hugo_gen_doc/ @@ -13,7 +13,7 @@ Generate Markdown documentation for the Hugo CLI. Generate Markdown documentation for the Hugo CLI. This command is, mostly, used to create up-to-date documentation -of Hugo's command-line interface for https://gohugo.io/. +of Hugo's command-line interface for http://gohugo.io/. It creates one Markdown file per command with front matter suitable for rendering in Hugo. @@ -50,4 +50,4 @@ hugo gen doc [flags] * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_gen_man.md b/content/en/commands/hugo_gen_man.md index a6f7b7534..47416cd23 100644 --- a/content/en/commands/hugo_gen_man.md +++ b/content/en/commands/hugo_gen_man.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo gen man" slug: hugo_gen_man url: /commands/hugo_gen_man/ @@ -46,4 +46,4 @@ hugo gen man [flags] * [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_import.md b/content/en/commands/hugo_import.md index 67b91e66c..7b2b5cf5d 100644 --- a/content/en/commands/hugo_import.md +++ b/content/en/commands/hugo_import.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo import" slug: hugo_import url: /commands/hugo_import/ @@ -42,4 +42,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_import_jekyll.md b/content/en/commands/hugo_import_jekyll.md index e126c2107..006c67358 100644 --- a/content/en/commands/hugo_import_jekyll.md +++ b/content/en/commands/hugo_import_jekyll.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo import jekyll" slug: hugo_import_jekyll url: /commands/hugo_import_jekyll/ @@ -46,4 +46,4 @@ hugo import jekyll [flags] * [hugo import](/commands/hugo_import/) - Import your site from others. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_list.md b/content/en/commands/hugo_list.md index 16bd1933e..bd15cb0fe 100644 --- a/content/en/commands/hugo_list.md +++ b/content/en/commands/hugo_list.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo list" slug: hugo_list url: /commands/hugo_list/ @@ -45,4 +45,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_list_all.md b/content/en/commands/hugo_list_all.md index 6a820ee18..73456867d 100644 --- a/content/en/commands/hugo_list_all.md +++ b/content/en/commands/hugo_list_all.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo list all" slug: hugo_list_all url: /commands/hugo_list_all/ @@ -43,4 +43,4 @@ hugo list all [flags] * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_list_drafts.md b/content/en/commands/hugo_list_drafts.md index 2dff18040..4806ee560 100644 --- a/content/en/commands/hugo_list_drafts.md +++ b/content/en/commands/hugo_list_drafts.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo list drafts" slug: hugo_list_drafts url: /commands/hugo_list_drafts/ @@ -43,4 +43,4 @@ hugo list drafts [flags] * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_list_expired.md b/content/en/commands/hugo_list_expired.md index 1703d9277..c6fc46c5f 100644 --- a/content/en/commands/hugo_list_expired.md +++ b/content/en/commands/hugo_list_expired.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo list expired" slug: hugo_list_expired url: /commands/hugo_list_expired/ @@ -43,4 +43,4 @@ hugo list expired [flags] * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_list_future.md b/content/en/commands/hugo_list_future.md index bb4621484..070104f52 100644 --- a/content/en/commands/hugo_list_future.md +++ b/content/en/commands/hugo_list_future.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo list future" slug: hugo_list_future url: /commands/hugo_list_future/ @@ -43,4 +43,4 @@ hugo list future [flags] * [hugo list](/commands/hugo_list/) - Listing out various types of content -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod.md b/content/en/commands/hugo_mod.md index f34cba2f3..64ccb14b3 100644 --- a/content/en/commands/hugo_mod.md +++ b/content/en/commands/hugo_mod.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod" slug: hugo_mod url: /commands/hugo_mod/ @@ -27,7 +27,7 @@ See https://gohugo.io/hugo-modules/ for more information. ### Options ``` - -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/ + -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 @@ -73,11 +73,12 @@ See https://gohugo.io/hugo-modules/ for more information. ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site -* [hugo mod clean](/commands/hugo_mod_clean/) - Delete the entire Hugo Module cache. +* [hugo mod clean](/commands/hugo_mod_clean/) - Delete the Hugo Module cache for the current project. * [hugo mod get](/commands/hugo_mod_get/) - Resolves dependencies in your current Hugo Project. * [hugo mod graph](/commands/hugo_mod_graph/) - Print a module dependency graph. * [hugo mod init](/commands/hugo_mod_init/) - Initialize this project as a Hugo Module. * [hugo mod tidy](/commands/hugo_mod_tidy/) - Remove unused entries in go.mod and go.sum. * [hugo mod vendor](/commands/hugo_mod_vendor/) - Vendor all module dependencies into the _vendor directory. +* [hugo mod verify](/commands/hugo_mod_verify/) - Verify dependencies. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_clean.md b/content/en/commands/hugo_mod_clean.md index ef21ddfcd..ff982f9f6 100644 --- a/content/en/commands/hugo_mod_clean.md +++ b/content/en/commands/hugo_mod_clean.md @@ -1,16 +1,16 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod clean" slug: hugo_mod_clean url: /commands/hugo_mod_clean/ --- ## hugo mod clean -Delete the entire Hugo Module cache. +Delete the Hugo Module cache for the current project. ### Synopsis -Delete the entire Hugo Module cache. +Delete the Hugo Module cache for the current project. Note that after you run this command, all of your dependencies will be re-downloaded next time you run "hugo". @@ -25,7 +25,9 @@ hugo mod clean [flags] ### Options ``` - -h, --help help for clean + --all clean entire module cache + -h, --help help for clean + --pattern string pattern matching module paths to clean (all if not set), e.g. "**hugo*" ``` ### Options inherited from parent commands @@ -49,4 +51,4 @@ hugo mod clean [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_get.md b/content/en/commands/hugo_mod_get.md index 678bcded5..7de0048bb 100644 --- a/content/en/commands/hugo_mod_get.md +++ b/content/en/commands/hugo_mod_get.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod get" slug: hugo_mod_get url: /commands/hugo_mod_get/ @@ -26,6 +26,7 @@ Install a specific version: Install the latest versions of all module dependencies: hugo mod get -u + hugo mod get -u ./... (recursive) Run "go help get" for more information. All flags available for "go get" is also relevant here. @@ -68,4 +69,4 @@ hugo mod get [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_graph.md b/content/en/commands/hugo_mod_graph.md index 397283180..ee01c8436 100644 --- a/content/en/commands/hugo_mod_graph.md +++ b/content/en/commands/hugo_mod_graph.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod graph" slug: hugo_mod_graph url: /commands/hugo_mod_graph/ @@ -45,4 +45,4 @@ hugo mod graph [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_init.md b/content/en/commands/hugo_mod_init.md index 53c5412f1..742df7c2a 100644 --- a/content/en/commands/hugo_mod_init.md +++ b/content/en/commands/hugo_mod_init.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod init" slug: hugo_mod_init url: /commands/hugo_mod_init/ @@ -50,4 +50,4 @@ hugo mod init [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_tidy.md b/content/en/commands/hugo_mod_tidy.md index 68e7ac2d1..31b138298 100644 --- a/content/en/commands/hugo_mod_tidy.md +++ b/content/en/commands/hugo_mod_tidy.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod tidy" slug: hugo_mod_tidy url: /commands/hugo_mod_tidy/ @@ -43,4 +43,4 @@ hugo mod tidy [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_vendor.md b/content/en/commands/hugo_mod_vendor.md index f3beb1253..1c838e01b 100644 --- a/content/en/commands/hugo_mod_vendor.md +++ b/content/en/commands/hugo_mod_vendor.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo mod vendor" slug: hugo_mod_vendor url: /commands/hugo_mod_vendor/ @@ -46,4 +46,4 @@ hugo mod vendor [flags] * [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_mod_verify.md b/content/en/commands/hugo_mod_verify.md new file mode 100644 index 000000000..29292b879 --- /dev/null +++ b/content/en/commands/hugo_mod_verify.md @@ -0,0 +1,48 @@ +--- +date: 2020-03-03 +title: "hugo mod verify" +slug: hugo_mod_verify +url: /commands/hugo_mod_verify/ +--- +## hugo mod verify + +Verify dependencies. + +### Synopsis + +Verify checks that the dependencies of the current module, which are stored in a local downloaded source cache, have not been modified since being downloaded. + + +``` +hugo mod verify [flags] +``` + +### Options + +``` + --clean delete module cache for dependencies that fail verification + -h, --help help for verify +``` + +### Options inherited from parent commands + +``` + --config string config file (default is path/config.yaml|json|toml) + --configDir string config dir (default "config") + --debug debug output + -e, --environment string build environment + --ignoreVendor ignores any _vendor directory + --log enable Logging + --logFile string log File path (if set, logging enabled automatically) + --quiet build in quiet mode + -s, --source string filesystem path to read files relative from + --themesDir string filesystem path to themes directory + -v, --verbose verbose output + --verboseLog verbose logging +``` + +### SEE ALSO + +* [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers. + +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_new.md b/content/en/commands/hugo_new.md index 4587f4475..a8b8458c3 100644 --- a/content/en/commands/hugo_new.md +++ b/content/en/commands/hugo_new.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo new" slug: hugo_new url: /commands/hugo_new/ @@ -26,7 +26,7 @@ hugo new [path] [flags] ### Options ``` - -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/ + -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 @@ -77,4 +77,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 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_new_site.md b/content/en/commands/hugo_new_site.md index 29ab9e8ef..df662d351 100644 --- a/content/en/commands/hugo_new_site.md +++ b/content/en/commands/hugo_new_site.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo new site" slug: hugo_new_site url: /commands/hugo_new_site/ @@ -47,4 +47,4 @@ hugo new site [path] [flags] * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_new_theme.md b/content/en/commands/hugo_new_theme.md index 8a97aad97..87026cdcd 100644 --- a/content/en/commands/hugo_new_theme.md +++ b/content/en/commands/hugo_new_theme.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo new theme" slug: hugo_new_theme url: /commands/hugo_new_theme/ @@ -46,4 +46,4 @@ hugo new theme [name] [flags] * [hugo new](/commands/hugo_new/) - Create new content for your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_server.md b/content/en/commands/hugo_server.md index 7d64bdc33..96cf3f16d 100644 --- a/content/en/commands/hugo_server.md +++ b/content/en/commands/hugo_server.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo server" slug: hugo_server url: /commands/hugo_server/ @@ -31,7 +31,7 @@ hugo server [flags] ``` --appendPort append port to baseURL (default true) - -b, --baseURL string hostname (and path) to the root, e.g. https://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") -D, --buildDrafts include content marked as draft -E, --buildExpired include expired content @@ -90,4 +90,4 @@ hugo server [flags] * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/commands/hugo_version.md b/content/en/commands/hugo_version.md index c0bc9359b..633fcd3c3 100644 --- a/content/en/commands/hugo_version.md +++ b/content/en/commands/hugo_version.md @@ -1,5 +1,5 @@ --- -date: 2019-07-31 +date: 2020-03-03 title: "hugo version" slug: hugo_version url: /commands/hugo_version/ @@ -43,4 +43,4 @@ hugo version [flags] * [hugo](/commands/hugo/) - hugo builds your site -###### Auto generated by spf13/cobra on 31-Jul-2019 +###### Auto generated by spf13/cobra on 3-Mar-2020 diff --git a/content/en/content-management/build-options.md b/content/en/content-management/build-options.md new file mode 100644 index 000000000..f402b9014 --- /dev/null +++ b/content/en/content-management/build-options.md @@ -0,0 +1,94 @@ +--- +title: Build Options +linktitle: Build Options +description: Build options help define how Hugo must treat a given page when building the site. +date: 2020-03-02 +publishdate: 2020-03-02 +keywords: [build,content,front matter, page resources] +categories: ["content management"] +menu: + docs: + parent: "content-management" + weight: 31 +weight: 31 #rem +draft: false +aliases: [/content/build-options/] +toc: true +--- + +They are stored in a reserved Front Matter object named `_build` with the following defaults: + +```yaml +_build: + render: true + list: true + publishResources: true +``` + +#### render +If true, the page will be treated as a published page, holding its dedicated output files (`index.html`, etc...) and permalink. + +#### list +If true, the page will be treated as part of the project's collections and, when appropriate, returned by Hugo's listing methods (`.Pages`, `.RegularPages` etc...). + +#### publishResources + +If set to true the [Bundle's Resources]({{< relref "content-management/page-bundles" >}}) will be published. +Setting this to false will still publish Resources on demand (when a resource's `.Permalink` or `.RelPermalink` is invoked from the templates) but will skip the others. + +{{% note %}} +Any page, regardless of their build options, will always be available using the [`.GetPage`]({{< relref "functions/GetPage" >}}) methods. +{{% /note %}} + +------ + +### Illustrative use cases + +#### Not publishing a page +Project needs a "Who We Are" content file for Front Matter and body to be used by the homepage but nowhere else. + +```yaml +# content/who-we-are.md` +title: Who we are +_build: + list: false + render: false +``` + +```go-html-template +{{/* layouts/index.html */}} +
+{{ with site.GetPage "who-we-are" }} + {{ .Content }} +{{ end }} +
+``` + +#### Listing pages without publishing them + +Website needs to showcase a few of the hundred "testimonials" available as content files without publishing any of them. + +To avoid setting the build options on every testimonials, one can use [`cascade`]({{< relref "/content-management/front-matter#front-matter-cascade" >}}) on the testimonial section's content file. + +```yaml +#content/testimonials/_index.md +title: Testimonials +# section build options: +_build: + render: true +# children build options with cascade +cascade: + _build: + render: false + list: true # default +``` + +```go-html-template +{{/* layouts/_defaults/testimonials.html */}} +
+{{ range first 5 .Pages }} +
+ {{ .Content }} +
+{{ end }} +
\ No newline at end of file diff --git a/content/en/content-management/image-processing/index.md b/content/en/content-management/image-processing/index.md index 0b9bcf323..9efb3b6bf 100644 --- a/content/en/content-management/image-processing/index.md +++ b/content/en/content-management/image-processing/index.md @@ -101,6 +101,17 @@ TAG: {{ $k }}: {{ $v }} {{ end }} ``` +Or individually access EXIF data with dot access, e.g.: + +```go-html-template +{{ with $img.Exif }} +Date: {{ .Date }} +Lat/Long: {{ .Lat }}/{{ .Long }} +Aperture: {{ .Tags.ApertureValue }} +Focal Length: {{ .Tags.FocalLength }} +{{ end }} +``` + #### Exif fields Date diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md index fbcd10c86..1c19726af 100644 --- a/content/en/content-management/shortcodes.md +++ b/content/en/content-management/shortcodes.md @@ -59,7 +59,7 @@ You can pass multiple lines as parameters to a shortcode by using raw string lit ``` {{HTML, -and a new line with a "quouted string".` */>}} +and a new line with a "quoted string".` */>}} ``` ### Shortcodes with Markdown diff --git a/content/en/contribute/development.md b/content/en/contribute/development.md index 70cb90069..bd76f9bbe 100644 --- a/content/en/contribute/development.md +++ b/content/en/contribute/development.md @@ -151,7 +151,7 @@ go install ``` -Hugo relies on [mage](github.com/magefile/mage) for some convenient build and test targets. If you don't already have it, get it: +Hugo relies on [mage](https://github.com/magefile/mage) for some convenient build and test targets. If you don't already have it, get it: ``` go get github.com/magefile/mage diff --git a/content/en/functions/hugo.md b/content/en/functions/hugo.md index d615fa721..26069633d 100644 --- a/content/en/functions/hugo.md +++ b/content/en/functions/hugo.md @@ -33,7 +33,7 @@ hugo.Version `hugo` returns an instance that contains the following functions: hugo.Environment -: the current running environment as defined through the `--environment` cli tag. +: the current running environment as defined through the `--environment` cli tag hugo.CommitHash : the git commit hash of the current Hugo binary e.g. `0e8bed9ccffba0df554728b46c5bbf6d78ae5247` @@ -41,7 +41,8 @@ hugo.CommitHash hugo.BuildDate : the compile date of the current Hugo binary formatted with RFC 3339 e.g. `2002-10-02T10:00:00-05:00` - +hugo.IsProduction +: returns true if `hugo.Environment` is set to the production environment {{% note "Use the Hugo Generator Tag" %}} We highly recommend using `hugo.Generator` in your website's ``. `hugo.Generator` is included by default in all themes hosted on [themes.gohugo.io](https://themes.gohugo.io). The generator tag allows the Hugo team to track the usage and popularity of Hugo. diff --git a/content/en/functions/math.md b/content/en/functions/math.md index eb38fdd0b..29fe16985 100644 --- a/content/en/functions/math.md +++ b/content/en/functions/math.md @@ -4,7 +4,7 @@ description: Hugo provides nine mathematical operators in templates. godocref: date: 2017-02-01 publishdate: 2017-02-01 -lastmod: 2017-02-01 +lastmod: 2020-02-23 keywords: [math, operators] categories: [functions] menu: @@ -36,3 +36,6 @@ aliases: [] | `math.Ceil` | Returns the least integer value greater than or equal to the given number. | `{{math.Ceil 2.1}}` → `3` | | `math.Floor` | Returns the greatest integer value less than or equal to the given number. | `{{math.Floor 1.9}}` → `1` | | `math.Round` | Returns the nearest integer, rounding half away from zero. | `{{math.Round 1.5}}` → `2` | +| `math.Log` | Returns the natural logarithm of the given number. | `{{math.Log 42}}` → `3.737` | +| `math.Sqrt` | Returns the square root of the given number. | `{{math.Sqrt 81}}` → `9` | + diff --git a/content/en/getting-started/configuration-markup.md b/content/en/getting-started/configuration-markup.md index c69bbb6ed..09816676a 100644 --- a/content/en/getting-started/configuration-markup.md +++ b/content/en/getting-started/configuration-markup.md @@ -134,7 +134,7 @@ PlainText Here is a code example for how the render-link.html template could look: {{< code file="layouts/_default/_markup/render-link.html" >}} -{{ .Text }} +{{ .Text | safeHTML }} {{< /code >}} #### Image Markdown example: diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md index b19cb45d9..33445a63c 100644 --- a/content/en/getting-started/configuration.md +++ b/content/en/getting-started/configuration.md @@ -87,6 +87,9 @@ baseURL blackfriday : See [Configure Blackfriday](/getting-started/configuration-markup#blackfriday) +build +: See [Configure Build](#configure-build) + buildDrafts (false) : Include drafts when building. @@ -135,7 +138,7 @@ enableEmoji (false) enableGitInfo (false) : Enable `.GitInfo` object for each page (if the Hugo site is versioned by Git). This will then update the `Lastmod` parameter for each page using the last git commit date for that content file. -enableInlineShortcodes +enableInlineShortcodes (false) : Enable inline shortcode support. See [Inline Shortcodes](/templates/shortcode-templates/#inline-shortcodes). enableMissingTranslationPlaceholders (false) @@ -288,6 +291,21 @@ enableemoji: true ``` {{% /note %}} +## Configure Build + +{{< new-in "0.66.0" >}} + +The `build` configuration section contains global build-realated configuration options. + +{{< code-toggle file="config">}} +[build] +useResourceCacheWhen="fallback" +{{< /code-toggle >}} + + +useResourceCacheWhen +: When to use the cached resources in `/resources/_gen` for PostCSS and ToCSS. Valid values are `never`, `always` and `fallback`. The last value means that the cache will be tried if PostCSS/extended version is not available. + ## Configure Title Case Set `titleCaseStyle` to specify the title style used by the [title](/functions/title/) template function and the automatic section titles in Hugo. It defaults to [AP Stylebook](https://www.apstylebook.com/) for title casing, but you can also set it to `Chicago` or `Go` (every word starts with a capital letter). diff --git a/content/en/hosting-and-deployment/hugo-deploy.md b/content/en/hosting-and-deployment/hugo-deploy.md index 81436b7f3..a571d366d 100644 --- a/content/en/hosting-and-deployment/hugo-deploy.md +++ b/content/en/hosting-and-deployment/hugo-deploy.md @@ -82,8 +82,13 @@ name = "mydeployment" # If you are using a CloudFront CDN, deploy will invalidate the cache as needed. cloudFrontDistributionID = - -# ... add more [[deployment.targets]] sections ... +# Optionally, you can include or exclude specific files. +# See https://godoc.org/github.com/gobwas/glob#Glob for the glob pattern syntax. +# If non-empty, the pattern is matched against the local path. +# If exclude is non-empty, and a file's path matches it, that file is dropped. +# If include is non-empty, and a file's path does not match it, that file is dropped. +# include = "**.html" # would only include files with ".html" suffix +# exclude = "**.{jpg, png}" # would exclude files with ".jpg" or ".png" suffix # [[deployment.matchers]] configure behavior for files that match the Pattern. diff --git a/content/en/hugo-modules/use-modules.md b/content/en/hugo-modules/use-modules.md index 71430700a..85417b5bf 100644 --- a/content/en/hugo-modules/use-modules.md +++ b/content/en/hugo-modules/use-modules.md @@ -46,6 +46,15 @@ Some examples: ```bash hugo mod get -u ``` + +### Update All Modules Recursively + +{{< new-in "0.65.0" >}} + +```bash +hugo mod get -u ./... +``` + ### Update One Module ```bash @@ -115,7 +124,7 @@ Also see the [CLI Doc](/commands/hugo_mod_clean/). Run `hugo mod clean` to delete the entire modules cache. -Note that you can also configure the `modules` cache with a `maxAge`, see [File Caches](/configuration/#configure-file-caches). +Note that you can also configure the `modules` cache with a `maxAge`, see [File Caches](/hugo-modules/configuration/#configure-file-caches). diff --git a/content/en/hugo-pipes/minification.md b/content/en/hugo-pipes/minification.md index ce090752f..c8136c040 100755 --- a/content/en/hugo-pipes/minification.md +++ b/content/en/hugo-pipes/minification.md @@ -22,4 +22,6 @@ Any resource of the aforementioned types can be minifed using `resources.Minify` ```go-html-template {{ $css := resources.Get "css/main.css" }} {{ $style := $css | resources.Minify }} -``` \ No newline at end of file +``` + +Note that you can also minify the final HTML output to `/public` by running `hugo --minify`. diff --git a/content/en/hugo-pipes/postcss.md b/content/en/hugo-pipes/postcss.md index a0a673798..a7ba097fa 100755 --- a/content/en/hugo-pipes/postcss.md +++ b/content/en/hugo-pipes/postcss.md @@ -39,6 +39,12 @@ config [string] noMap [bool] : Default is `true`. Disable the default inline sourcemaps +inlineImports [bool] {{< new-in "0.66.0" >}} +: Default is `false`. Enable inlining of @import statements. It does so recursively, but will only import a file once. +URL imports (e.g. `@import url('https://fonts.googleapis.com/css?family=Open+Sans&display=swap');`) and imports with media queries will be ignored. +Note that this import routine does not care about the CSS spec, so you can have @import anywhere in the file. +Hugo will look for imports relative to the module mount and will respect theme overrides. + _If no configuration file is used:_ use [string] @@ -55,4 +61,21 @@ syntax [string] ```go-html-template {{ $style := resources.Get "css/main.css" | resources.PostCSS (dict "config" "customPostCSS.js" "noMap" true) }} +``` + +## Check Hugo Environment from postcss.config.js + +{{< new-in "0.66.0" >}} + +The current Hugo environment name (set by `--environment` or in config or OS environment) is available in the Node context, which allows constructs like this: + +```js +module.exports = { + plugins: [ + require('autoprefixer'), + ...process.env.HUGO_ENVIRONMENT === 'production' + ? [purgecss] + : [] + ] +} ``` \ No newline at end of file diff --git a/content/en/news/0.65.0-relnotes/hugo-65-poster-featured.png b/content/en/news/0.65.0-relnotes/hugo-65-poster-featured.png new file mode 100644 index 000000000..a311df0cb Binary files /dev/null and b/content/en/news/0.65.0-relnotes/hugo-65-poster-featured.png differ diff --git a/content/en/news/0.65.0-relnotes/index.md b/content/en/news/0.65.0-relnotes/index.md new file mode 100644 index 000000000..1a2edb907 --- /dev/null +++ b/content/en/news/0.65.0-relnotes/index.md @@ -0,0 +1,141 @@ + +--- +date: 2020-02-20 +title: "0.65.0: Hugo Reloaded!" +description: "Draft, expire, resource bundling, and fine grained publishing control for any page. And it's faster." +categories: ["Releases"] +--- + +**Hugo 0.65** generalizes how a page is packaged and published to be applicable to **any page**. This should solve some of the most common issues we see people ask and talk about on the [issue tracker](https://github.com/gohugoio/hugo/issues) and on the [forum](https://discourse.gohugo.io/). + +## Release Highlights + +### New in Hugo Core + +Any [branch node](https://gohugo.io/content-management/page-bundles/#branch-bundles) can now bundle resources (images, data files etc.), even the taxonomy nodes (e.g. /categories). + +List pages (sections and the home page) can now be added to taxonomies. + +The front matter fields that control when and if to publish a piece of content (`draft`, `publishDate`, `expiryDate`) now also works for list pages, and is recursive. + +We have added a new `_build` front matter keyword to provide fine-grained control over page publishing. The default values: + +```yaml +_build: +  # Whether to add it to any of the page collections. +  # Note that the page can still be found with .Site.GetPage. +  list: true +  +  # Whether to render it. +  render: true +  +  # Whether to publish its resources. These will still be published on demand, +  # but enabling this can be useful if the originals (e.g. images) are +  # never used. +  publishResources: true +``` + +Note that all front matter keywords can be set in the [cascade](https://gohugo.io/content-management/front-matter#front-matter-cascade) on a branch node, which would be especially useful for `_build`. + +We have also upgraded to the latest LibSass (v3.6.3). Nothing remarkable functional new here, but it makes Hugo ready for the upcoming [Dart Backport](https://github.com/sass/libsass/pull/2918). + +And finally, we have added a `GetTerms` method on `Page`, making listing the terms defined on this page in the given taxonomy much simpler: + +```go-html-template + +``` + +### New in Hugo Modules + +There are several improvements to the tooling used in [Hugo Modules](https://gohugo.io/hugo-modules/). One bug fix, but also some improvements to make it easier to manage: + +* You can now recursively update your modules with `hugo mod get -u ./...` +* `hugo mod clean` will now only clean the cache for the current project and now also takes an optional module path pattern, e.g. `hugo mod clean --pattern "github.com/**"` +* A new command `hugo mod verify` is added to verify that the module cache matches the hashes in `go.sum`. Run with `hugo mod verify --clean` to delete any modules that fail this check. + +See [hugo mod](https://gohugo.io/commands/hugo_mod/#see-also). + +### Performance + +The new features listed above required a structural simplification, and we do watch our weight when doing this. And the benchmarks show that Hugo should, in general, be slightly faster. This is especially true if you're using taxonomies, and the partial rebuilding on content changes should be considerably faster. + +## Numbers + +This release represents **34 contributions by 6 contributors** to the main Hugo code base.[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@satotake](https://github.com/satotake), [@QuLogic](https://github.com/QuLogic), and [@JaymoKang](https://github.com/JaymoKang) for their ongoing contributions. +And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) and [@onedrawingperday](https://github.com/onedrawingperday) for their relentless work on keeping the themes site in pristine condition and to [@davidsneighbour](https://github.com/davidsneighbour) and [@kaushalmodi](https://github.com/kaushalmodi) for all the great work on the documentation site. + +Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs), +which has received **7 contributions by 4 contributors**. A special thanks to [@coliff](https://github.com/coliff), [@bep](https://github.com/bep), [@tibnew](https://github.com/tibnew), and [@nerg4l](https://github.com/nerg4l) for their work on the documentation site. + +Hugo now has: + +* 41724+ [stars](https://github.com/gohugoio/hugo/stargazers) +* 439+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors) +* 299+ [themes](http://themes.gohugo.io/) + +## Notes + +* `.GetPage "members.md"` (the Page method) will now only do relative lookups, which is what most people would expect. +* There have been a slight change of how disableKinds for regular pages: They will not be rendered on its own, but will be added to the site collections. + +## Enhancements + +### Templates + +* Adjust the RSS taxonomy logic [d73e3738](https://github.com/gohugoio/hugo/commit/d73e37387ca0012bd58bd3f36a0477854b41ab6e) [@bep](https://github.com/bep) [#6909](https://github.com/gohugoio/hugo/issues/6909) + +### Output + +* Handle disabled RSS even if it's defined in outputs [da54787c](https://github.com/gohugoio/hugo/commit/da54787cfa97789624e467a4451dfeb50f563e41) [@bep](https://github.com/bep) + +### Other + +* Regenerate CLI docs [a5ebdf7d](https://github.com/gohugoio/hugo/commit/a5ebdf7d17e6c6a9dc686cf8f7cd8e0a1bab5f2d) [@bep](https://github.com/bep) +* Improve "hugo mod clean" [dce210ab](https://github.com/gohugoio/hugo/commit/dce210ab56fc885818fc5d1a084a1c3ba84e7929) [@bep](https://github.com/bep) [#6907](https://github.com/gohugoio/hugo/issues/6907) +* Add "hugo mod verify" [0b96aba0](https://github.com/gohugoio/hugo/commit/0b96aba022d51cf9939605c029bb8dba806653a1) [@bep](https://github.com/bep) [#6907](https://github.com/gohugoio/hugo/issues/6907) +* Add Page.GetTerms [fa520a2d](https://github.com/gohugoio/hugo/commit/fa520a2d983b982394ad10088393fb303e48980a) [@bep](https://github.com/bep) [#6905](https://github.com/gohugoio/hugo/issues/6905) +* Add a list terms benchmark [7489a864](https://github.com/gohugoio/hugo/commit/7489a864591b6df03f435f40696c6ceeb4776ec9) [@bep](https://github.com/bep) [#6905](https://github.com/gohugoio/hugo/issues/6905) +* Use the tree for taxonomy.Pages() [b2dcd53e](https://github.com/gohugoio/hugo/commit/b2dcd53e3c0240c4afd21d1818fd180c2d1b9d34) [@bep](https://github.com/bep) +* Add some cagegories to the site collections benchmarks [36983e61](https://github.com/gohugoio/hugo/commit/36983e6189a717f1d4d1da6652621d7f8fe186ad) [@bep](https://github.com/bep) +* Do not try to get local themes in "hugo mod get" [20f2211f](https://github.com/gohugoio/hugo/commit/20f2211fce55e1811629245f9e5e4a2ac754d788) [@bep](https://github.com/bep) [#6893](https://github.com/gohugoio/hugo/issues/6893) +* Update goldmark-highlighting [a21a9373](https://github.com/gohugoio/hugo/commit/a21a9373e06091ab70d8a5f4da8ff43f7c609b4b) [@satotake](https://github.com/satotake) +* Support "hugo mod get -u ./..." [775c7c24](https://github.com/gohugoio/hugo/commit/775c7c2474d8797c96c9ac529a3cd93c0c2d3514) [@bep](https://github.com/bep) [#6828](https://github.com/gohugoio/hugo/issues/6828) +* Introduce a tree map for all content [eada236f](https://github.com/gohugoio/hugo/commit/eada236f87d9669885da1ff647672bb3dc6b4954) [@bep](https://github.com/bep) [#6312](https://github.com/gohugoio/hugo/issues/6312)[#6087](https://github.com/gohugoio/hugo/issues/6087)[#6738](https://github.com/gohugoio/hugo/issues/6738)[#6412](https://github.com/gohugoio/hugo/issues/6412)[#6743](https://github.com/gohugoio/hugo/issues/6743)[#6875](https://github.com/gohugoio/hugo/issues/6875)[#6034](https://github.com/gohugoio/hugo/issues/6034)[#6902](https://github.com/gohugoio/hugo/issues/6902)[#6173](https://github.com/gohugoio/hugo/issues/6173)[#6590](https://github.com/gohugoio/hugo/issues/6590) +* Another benchmark rename [e5329f13](https://github.com/gohugoio/hugo/commit/e5329f13c02b87f0c30f8837759c810cd90ff8da) [@bep](https://github.com/bep) +* Rename the Edit benchmarks [5b145ddc](https://github.com/gohugoio/hugo/commit/5b145ddc4c951a827e1ac00444dc4719e53e0885) [@bep](https://github.com/bep) +* Refactor a benchmark to make it runnable as test [54bdcaac](https://github.com/gohugoio/hugo/commit/54bdcaacaedec178554e696f34647801bbe61362) [@bep](https://github.com/bep) +* Add benchmark for content edits [1622510a](https://github.com/gohugoio/hugo/commit/1622510a5c651b59a79f64e9dc3cacd24832ec0b) [@bep](https://github.com/bep) +* Add "go mod verify" to build scripts [56d0b658](https://github.com/gohugoio/hugo/commit/56d0b658879bbf476810d013176d6568553aa71e) [@bep](https://github.com/bep) +* Add git to Dockerfile [75c3787f](https://github.com/gohugoio/hugo/commit/75c3787fc254d933fa11e5c39d978bfa1a21a371) [@JaymoKang](https://github.com/JaymoKang) +* Update go.sum [9babb1f0](https://github.com/gohugoio/hugo/commit/9babb1f0c4fca048b0339f6ce3618f88d34e0457) [@bep](https://github.com/bep) +* Rename doWithCommandeer to cfgInit/cfgSetAndInit [8a5124d6](https://github.com/gohugoio/hugo/commit/8a5124d6b38156cb6f765ac7492513ac7c0d90b2) [@MarkRosemaker](https://github.com/MarkRosemaker) +* Update golibsass [898a0a96](https://github.com/gohugoio/hugo/commit/898a0a96afd472fad8fe70be71f6cb00a4267c4a) [@bep](https://github.com/bep) [#6885](https://github.com/gohugoio/hugo/issues/6885) +* Shuffle test files before insertion [3b721110](https://github.com/gohugoio/hugo/commit/3b721110d560c8831c282e6e7a5c510fe7a5129a) [@bep](https://github.com/bep) +* Update to LibSass v3.6.3 [40ba7e6d](https://github.com/gohugoio/hugo/commit/40ba7e6d63c1a0734f257a642e46eb1572116a32) [@bep](https://github.com/bep) [#6862](https://github.com/gohugoio/hugo/issues/6862) +* Update Go version requirement [23ea4318](https://github.com/gohugoio/hugo/commit/23ea43180b84e35d99e88083a83e7ca1916b3b36) [@bep](https://github.com/bep) [#6853](https://github.com/gohugoio/hugo/issues/6853) + +## Fixes + +### Templates + +* Fix RSS template for the terms listing [aa3e1830](https://github.com/gohugoio/hugo/commit/aa3e1830568cabaa8bf3277feeba6cb48746e40c) [@bep](https://github.com/bep) [#6909](https://github.com/gohugoio/hugo/issues/6909) + +### Other + +* Fix lazy publishing with publishResources=false [9bdedb25](https://github.com/gohugoio/hugo/commit/9bdedb251c7cd8f8af800c7d9914cf84292c5c50) [@bep](https://github.com/bep) [#6914](https://github.com/gohugoio/hugo/issues/6914) +* Fix goMinorVersion on non-final Go releases [c7975b48](https://github.com/gohugoio/hugo/commit/c7975b48b6532823868a6aa8c93eb76caa46c570) [@QuLogic](https://github.com/QuLogic) +* Fix taxonomy [1b7acfe7](https://github.com/gohugoio/hugo/commit/1b7acfe7634a5d7bbc597ef4dddf4babce5666c5) [@bep](https://github.com/bep) +* Fix RenderString for pages without content [19e12caf](https://github.com/gohugoio/hugo/commit/19e12caf8c90516e3b803ae8a40b907bd89dc96c) [@bep](https://github.com/bep) [#6882](https://github.com/gohugoio/hugo/issues/6882) +* Fix chroma highlight [3c568ad0](https://github.com/gohugoio/hugo/commit/3c568ad0139c79e5c0596ca40637512d71401afc) [@satotake](https://github.com/satotake) [#6877](https://github.com/gohugoio/hugo/issues/6877)[#6856](https://github.com/gohugoio/hugo/issues/6856) +* Fix mount with hole regression [b78576fd](https://github.com/gohugoio/hugo/commit/b78576fd38a76bbdaab5ad21228c8e5a559090b1) [@bep](https://github.com/bep) [#6854](https://github.com/gohugoio/hugo/issues/6854) +* Fix bundle resource ordering regression [18888e09](https://github.com/gohugoio/hugo/commit/18888e09bbb5325bdd63f2cd93116ff490dd37ab) [@bep](https://github.com/bep) [#6851](https://github.com/gohugoio/hugo/issues/6851) +* Fix note about CGO [7f0ebd4a](https://github.com/gohugoio/hugo/commit/7f0ebd4a3c9e016afddc2cf5e7dfe6a820aa099a) [@moorereason](https://github.com/moorereason) + + + + + diff --git a/content/en/news/0.65.0-relnotes/pg-admin-tos.png b/content/en/news/0.65.0-relnotes/pg-admin-tos.png new file mode 100644 index 000000000..fc2f4e34d Binary files /dev/null and b/content/en/news/0.65.0-relnotes/pg-admin-tos.png differ diff --git a/content/en/news/0.65.1-relnotes/index.md b/content/en/news/0.65.1-relnotes/index.md new file mode 100644 index 000000000..07ee66569 --- /dev/null +++ b/content/en/news/0.65.1-relnotes/index.md @@ -0,0 +1,20 @@ + +--- +date: 2020-02-20 +title: "Hugo 0.65.1: A couple of Bug Fixes" +description: "This version fixes a couple of bugs introduced in 0.65.0." +categories: ["Releases"] +images: +- images/blog/hugo-bug-poster.png + +--- + + + +This is a bug-fix release with a couple of important fixes. + +* hugolib: Fix 2 Paginator.Pages taxonomy regressions [7ef5a4c8](https://github.com/gohugoio/hugo/commit/7ef5a4c83e4560bced3eee0ccf0e0db176146f44) [@bep](https://github.com/bep) [#6921](https://github.com/gohugoio/hugo/issues/6921)[#6918](https://github.com/gohugoio/hugo/issues/6918) +* hugolib: Fix deletion of orphaned sections [a70bbd06](https://github.com/gohugoio/hugo/commit/a70bbd0696df3b0a6889650e48a07f8223151da4) [@bep](https://github.com/bep) [#6920](https://github.com/gohugoio/hugo/issues/6920) + + + diff --git a/content/en/news/0.65.2-relnotes/index.md b/content/en/news/0.65.2-relnotes/index.md new file mode 100644 index 000000000..ee9280976 --- /dev/null +++ b/content/en/news/0.65.2-relnotes/index.md @@ -0,0 +1,21 @@ + +--- +date: 2020-02-21 +title: "Hugo 0.65.2: A couple of Bug Fixes" +description: "This version fixes a couple of bugs introduced in 0.65.0." +categories: ["Releases"] +images: +- images/blog/hugo-bug-poster.png + +--- + + + +This is a bug-fix release with a couple of important fixes. + +* Apply missing go fmt [76b2afe6](https://github.com/gohugoio/hugo/commit/76b2afe642c37aedc7269b41d6fca5b78f467ce4) [@bep](https://github.com/bep) +* Fix panic on no output formats