shithub: hugo

--- a/docs/content/en/content-management/image-processing/index.md

+++ b/docs/content/en/content-management/image-processing/index.md

@@ -294,7 +294,7 @@

 ## Smart Cropping of Images

-By default, Hugo will use the [Smartcrop](https://github.com/muesli/smartcrop), a library created by [muesli](https://github.com/muesli), when cropping images with `.Fill`. You can set the anchor point manually, but in most cases the smart option will make a good choice. And we will work with the library author to improve this in the future.

+By default, Hugo will use [Smartcrop](https://github.com/muesli/smartcrop), a library created by [muesli](https://github.com/muesli), when cropping images with `.Fill`. You can set the anchor point manually, but in most cases the smart option will make a good choice. And we will work with the library author to improve this in the future.

 An example using the sunset image from above:

--- a/docs/content/en/content-management/page-bundles.md

+++ b/docs/content/en/content-management/page-bundles.md

@@ -18,8 +18,8 @@

 A Page Bundle can be one of:

--   Leaf Bundle (leaf means it has no children)

--   Branch Bundle (home page, section, taxonomy terms, taxonomy list)

+- Leaf Bundle (leaf means it has no children)

+- Branch Bundle (home page, section, taxonomy terms, taxonomy list)

 |                                     | Leaf Bundle                                              | Branch Bundle                                                                                                                                                                                                      |

 |-------------------------------------|----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------  |

--- a/docs/content/en/content-management/related.md

+++ b/docs/content/en/content-management/related.md

@@ -72,7 +72,7 @@

 Without any `related` configuration set on the project, Hugo's Related Content methods will use the following.

-```yaml

+{{< code-toggle file="config" >}}

 related:

   threshold: 80

   includeNewer: false

@@ -82,7 +82,7 @@

     weight: 100

   - name: date

     weight: 10

-```

+{{< /code-toggle >}}

 Custom configuration should be set using the same syntax.

--- a/docs/content/en/content-management/syntax-highlighting.md

+++ b/docs/content/en/content-management/syntax-highlighting.md

@@ -16,7 +16,6 @@

 toc: true

---

 Hugo uses [Chroma](https://github.com/alecthomas/chroma) as its code highlighter; it is built in Go and is really, really fast -- and for the most important parts compatible with Pygments we used before.

 ## Configure Syntax Highlighter

@@ -23,7 +22,6 @@

 See [Configure Highlight](/getting-started/configuration-markup#highlight).

 ## Generate Syntax Highlighter CSS

 If you run with `pygmentsUseClasses=true` in your site config, you need a style sheet.

@@ -36,7 +34,6 @@

 Run `hugo gen chromastyles -h` for more options. See https://xyproto.github.io/splash/docs/ for a gallery of available styles.

 ## Highlight Shortcode

 Highlighting is carried out via the [built-in shortcode](/content-management/shortcodes/) `highlight`. `highlight` takes exactly one required parameter for the programming language to be highlighted and requires a closing shortcode. Note that `highlight` is *not* used for client-side javascript highlighting.

@@ -79,8 +76,6 @@

 {{< / highlight >}}

 ## Highlight Template Func

--- a/docs/content/en/contribute/themes.md

+++ b/docs/content/en/contribute/themes.md

@@ -24,9 +24,8 @@

 Another great site for Hugo themes is [jamstackthemes.dev/](https://jamstackthemes.dev/ssg/hugo/).

 ### Add Your Theme to the Repo

-In order to add your Hugo theme to [themes.gohugo.io] please [open up a new issue in the theme repository](https://github.com/gohugoio/hugoThemes/issues/new?template=theme-submission.md). **Please make sure that you've read the theme submission guidelines in the [README](https://github.com/gohugoio/hugoThemes/blob/master/README.md#adding-a-theme-to-the-list) of the hugoThemes repository.**

+In order to add your Hugo theme to [themes.gohugo.io] please [open up a new issue in the theme repository](https://github.com/gohugoio/hugoThemes/issues/new?template=theme-submission.md). **Please make sure that you've read the theme submission guidelines in the [README](https://github.com/gohugoio/hugoThemes/blob/master/README.md#adding-a-theme-to-the-list) of the hugoThemes repository.**

 [themes.gohugo.io]: https://themes.gohugo.io/

--- a/docs/content/en/functions/after.md

+++ b/docs/content/en/functions/after.md

@@ -62,5 +62,5 @@

 [`first` function]: /functions/first/

 [list/section page]: /templates/section-templates/

-[lists]: /lists/

+[lists]: /templates/lists/#order-content

 [slice]: /functions/slice/

--- a/docs/content/en/hosting-and-deployment/deployment-with-wercker.md

+++ b/docs/content/en/hosting-and-deployment/deployment-with-wercker.md

@@ -289,8 +289,6 @@

 [The source code for the site used in this guide is available on GitHub][guidesource], as is the [Wercker Hugo Build step][guidestep].

-If you want to see an example of how you can deploy to S3 instead of GitHub pages, check [Wercker's documentation][werckerdocs] for guidance on setup.

 [1]: /images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.png

 [2]: /images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.png

 [3]: /images/hosting-and-deployment/deployment-with-wercker/wercker-sign-up.png

@@ -321,4 +319,3 @@

 [hugoconfig]: /getting-started/configuration/

 [publicappurl]: https://app.wercker.com/#applications/5586dcbdaf7de9c51b02b0d5

 [quickstart]: /getting-started/quick-start/

-[werckerdocs]: http://devcenter.wercker.com/docs/deploy/s3.html

--- a/docs/content/en/hosting-and-deployment/hosting-on-bitbucket.md

+++ b/docs/content/en/hosting-and-deployment/hosting-on-bitbucket.md

@@ -56,11 +56,10 @@

 We will now create a git repository and then push our code to Bitbucket. In Bitbucket, create a repository.

-![][1]

+![Bitbucket Screenshot][1]

 [1]: /images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png

```

 # initialize new git repository

 git init

@@ -133,10 +132,9 @@

 At this point, you can now create and edit blog posts directly in the Bitbucket UI.

-![][2]

+![Bitbucket blog Screenshot][2]

 [2]: /images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png

 ## Suggested next steps

--- a/docs/content/en/hosting-and-deployment/hosting-on-gitlab.md

+++ b/docs/content/en/hosting-and-deployment/hosting-on-gitlab.md

@@ -77,6 +77,10 @@

 After the build has passed, your new website is available at `https://<YourUsername>.gitlab.io/<your-hugo-site>/`.

+{{% note %}}

+Make sure your `baseURL` key-value in your [site configuration](/getting-started/configuration/) reflects the full URL of your GitLab pages repository if you're using the default GitLab Pages URL (e.g., `https://<YourUsername>.gitlab.io/<your-hugo-site>/`) and not a custom domain.

+{{% /note %}}

 ## Next Steps

 GitLab supports using custom CNAME's and TLS certificates. For more details on GitLab Pages, see the [GitLab Pages setup documentation](https://about.gitlab.com/2016/04/07/gitlab-pages-setup/).

--- a/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md

+++ b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md

@@ -66,7 +66,7 @@

     - master

```

-Using this integration method,  you will have to specify the Zone ID and your [KeyCDN API](https://www.keycdn.com/api) key as secret variables. To do this, navigate to the top-left menu bar in GitLab and select Projects. Then, select your project and click on the Settings page. Finally, select Pipelines from the sub-menu and scroll down to the Secret Variable section.

+Using this integration method,  you will have to specify the Zone ID and your [KeyCDN API](https://www.keycdn.com/api) key as secret variables. To do this, navigate to the top-left menu bar in GitLab and select Projects. Then, select your project and click on the Settings page. Finally, select Pipelines from the sub-menu and scroll down to the Secret Variable section.

 The Secret Variable for your Zone ID should look similar to:

@@ -89,6 +89,6 @@

 You can watch the progress and CI job output in your Gitlab project under “Pipelines”.

-After verifying your CI job ran without issues, first check that your GitLab page shows up under `https://youruser.gitlab.io/reponame/` (it might look broken depending on your browser settings as all links point to your KeyCDN zone – don’t worry about that) and then by heading to whatever Zonealias / Zone URL you defined.

+After verifying your CI job ran without issues, first check that your GitLab page shows up under `https://youruser.gitlab.io/reponame/` (it might look broken depending on your browser settings as all links point to your KeyCDN zone – don’t worry about that) and then by heading to whatever Zone alias / Zone URL you defined.

 To learn more about Hugo hosting options with KeyCDN, check out the complete [Hugo hosting with KeyCDN integration guide](https://www.keycdn.com/support/hugo-hosting/).

--- a/docs/content/en/hugo-pipes/introduction.md

+++ b/docs/content/en/hugo-pipes/introduction.md

@@ -50,3 +50,15 @@

 {{ $style := resources.Get "sass/main.scss" | toCSS | minify | fingerprint }}

 <link rel="stylesheet" href="{{ $style.Permalink }}">

```

+### Caching

+Hugo Pipes invocations are cached based on the entire _pipe chain_.

+An example of a pipe chain is:

+```go-html-template

+{{ $mainJs := resources.Get "js/main.js" | js.Build "main.js" | minify | fingerprint }}

+```

+The pipe chain is only invoked the first time it is encountered in a site build, and results are otherwise loaded from cache. As such, Hugo Pipes can be used in templates which are executed thousands or millions of times without negatively impacting the build performance.

--- a/docs/content/en/hugo-pipes/js.md

+++ b/docs/content/en/hugo-pipes/js.md

@@ -45,7 +45,7 @@

 {{ $defines := dict "process.env.NODE_ENV" `"development"` }}

```

-format [string] {{< new-in "0.75.0" >}}

+format [string] {{< new-in "0.74.3" >}}

 : The output format.

   One of: `iife`, `cjs`, `esm`.

   Default is `iife`, a self-executing function, suitable for inclusion as a <script> tag.

--- a/docs/content/en/templates/internal.md

+++ b/docs/content/en/templates/internal.md

@@ -152,7 +152,7 @@

 - The first 6 `tags` on the page are used for the tags metadata.

 - The `series` taxonomy is used to specify related "see also" pages by placing them in the same series.

-If using YouTube this will produce a og:video tag like `<meta property="og:video" content="url">`. If using a YouTube link make sure this is in **https://www.youtube.com/v/NlXVWtgLNjY** not __https://www.youtube.com/watch?v=NlXVWtgLNjY__

+If using YouTube this will produce a og:video tag like `<meta property="og:video" content="url">`. Use the `https://youtu.be/<id>` format with YouTube videos (example: `https://youtu.be/qtIqKaDlqXo`).

 ### Use the Open Graph Template

--- a/docs/content/en/variables/site.md

+++ b/docs/content/en/variables/site.md

@@ -22,7 +22,7 @@

 ## Get the Site object from a partial

-All the methods below, e.g. `.Site.RegularPages` can also be reached via the global `site` function, e.g. `site.RegularPages`, which can be handy in partials where the `Page` object isn't easily available. {{< new-in "0.53.0" >}}.

+All the methods below, e.g. `.Site.RegularPages` can also be reached via the global `site` function, e.g. `site.RegularPages`, which can be handy in partials where the `Page` object isn't easily available. {{< new-in "0.53" >}}.

 ## Site Variables List

--- a/docs/netlify.toml

+++ b/docs/netlify.toml

@@ -3,7 +3,7 @@

 command = "hugo --gc --minify"

 [context.production.environment]

-HUGO_VERSION = "0.74.2"

+HUGO_VERSION = "0.74.3"

 HUGO_ENV = "production"

 HUGO_ENABLEGITINFO = "true"

@@ -11,7 +11,7 @@

 command = "hugo --gc --minify --enableGitInfo"

 [context.split1.environment]

-HUGO_VERSION = "0.74.2"

+HUGO_VERSION = "0.74.3"

 HUGO_ENV = "production"

 [context.deploy-preview]

@@ -18,13 +18,13 @@

 command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"

 [context.deploy-preview.environment]

-HUGO_VERSION = "0.74.2"

+HUGO_VERSION = "0.74.3"

 [context.branch-deploy]

 command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"

 [context.branch-deploy.environment]

-HUGO_VERSION = "0.74.2"

+HUGO_VERSION = "0.74.3"

 [context.next.environment]

 HUGO_ENABLEGITINFO = "true"