resource_transformers/tocss: Fixed hugo:vars casting

Variables passed via the hugo:vars function where passed as type string.
This caused problems when using the variables in sass functions because
these expect a specific type. Now we check if the passed variables have
to be quoted and therefore are of type string or if they should not be
quoted and let the type interpretation up to the sass compiler.

Fixes #10632

Adjust tests for GO 1.20

Updates #10691

tpl/internal: Sync Go template src to Go 1.20

Updates #10691

build: Update to Go 1.20

Updates #10691

Add page fragments support to Related

The main topic of this commit is that you can now index fragments (content heading identifiers) when calling `.Related`.

You can do this by:

* Configure one or more indices with type `fragments`
* The name of those index configurations maps to an (optional) front matter slice with fragment references. This allows you to link
page<->fragment and page<->page.
* This also will index all the fragments (heading identifiers) of the pages.

It's also possible to use type `fragments` indices in shortcode, e.g.:

```
{{ $related := site.RegularPages.Related .Page }}
```

But, and this is important, you need to include the shortcode using the `{{<` delimiter. Not doing so will create infinite loops and timeouts.

This commit also:

* Adds two new methods to Page: Fragments (can also be used to build ToC) and HeadingsFiltered (this is only used in Related Content with
index type `fragments` and `enableFilter` set to true.
* Consolidates all `.Related*` methods into one, which takes either a `Page` or an options map as its only argument.
* Add `context.Context` to all of the content related Page API. Turns out it wasn't strictly needed for this particular feature, but it will
soon become usefil, e.g. in #9339.

Closes #10711
Updates #9339
Updates #10725

related: Adjust benchmark

To make it easier to compare.

related: Add benchmark

tpl/collections: Improve error message in Index

Make the HTML collector parsing more robust

Most notably better handling self-closing elements

Closes #10698

Revert "build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0"

This reverts commit 87c78bd3e918f258bc1a4b0e8acdcec11b69bd35.

There seem to be some breaking changes in the above that needs to be looked into.

deps: Upgrade github.com/yuin/goldmark v1.5.3 => v1.5.4

Closes #10661

tpl/strings: Add strings.ContainsNonSpace

build(deps): bump github.com/getkin/kin-openapi from 0.110.0 to 0.114.0

Bumps [github.com/getkin/kin-openapi](https://github.com/getkin/kin-openapi) from 0.110.0 to 0.114.0.
- [Release notes](https://github.com/getkin/kin-openapi/releases)
- [Commits](https://github.com/getkin/kin-openapi/compare/v0.110.0...v0.114.0)

---
updated-dependencies:
- dependency-name: github.com/getkin/kin-openapi
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

deps: Upgrade github.com/alecthomas/chroma v2.4.0 => v2.5.0

Fixes #9890
Fixes #10692

markup: Fix linenos codeblock hl option case regression

This fixes a regression introduced in v0.93.0 where previously, a
mixed-case key for lineNos would be successfully parsed. This change
moves the configuration key lowercasing step into the configuration
normalization stage, which is called whether the highlighting config
is being parsed from a `string` or a `map`.

Fixes #10682

Fix slow HTML elements collector for the pre case

```
name                           old time/op    new time/op    delta
ElementsCollectorWriterPre-10    25.2µs ± 1%     3.4µs ± 0%  -86.54%  (p=0.029 n=4+4)

name                           old alloc/op   new alloc/op   delta
ElementsCollectorWriterPre-10      624B ± 0%      142B ± 0%  -77.18%  (p=0.029 n=4+4)

name                           old allocs/op  new allocs/op  delta
ElementsCollectorWriterPre-10      16.0 ± 0%       6.0 ± 0%  -62.50%  (p=0.029 n=4+4)
```

Fixes #10698

publisher: Add benchmark

snap: Install dart-sass-embedded for 32-bit ARM (armhf) too

See https://github.com/sass/dart-sass-embedded/releases/tag/1.54.7
which "Add[ed] support for 32-bit ARM releases on Linux" on 2022-08-30.

snap: Add read access for ~/.gitconfig.local and ~/.config/git/* too

in hugo:gitconfig plug (personal-files interface) in case end users need
the flexibility of using additional custom git config files.

Fixes #10337

commands: Fix server url rewrites (http status 200)

Broken by me in Hugo 0.103.0 it seems. A little bit mysterious as it has worked for me after that, but started to fail just
recently.

Closes #10668

build(deps): bump github.com/kyokomi/emoji/v2 from 2.2.10 to 2.2.11

Bumps [github.com/kyokomi/emoji/v2](https://github.com/kyokomi/emoji) from 2.2.10 to 2.2.11.
- [Release notes](https://github.com/kyokomi/emoji/releases)
- [Commits](https://github.com/kyokomi/emoji/compare/v2.2.10...v2.2.11)

---
updated-dependencies:
- dependency-name: github.com/kyokomi/emoji/v2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

build(deps): bump gocloud.dev from 0.24.0 to 0.28.0 (#10610)

Bumps [gocloud.dev](https://github.com/google/go-cloud) from 0.24.0 to 0.28.0.
- [Release notes](https://github.com/google/go-cloud/releases)
- [Commits](https://github.com/google/go-cloud/compare/v0.24.0...v0.28.0)

---
updated-dependencies:
- dependency-name: gocloud.dev
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Closes #9778

Fix description of collections.Uniq

Update CONTRIBUTING.md

Fix shortcode detection in RenderString

Fixes #10654

Only invoke a given cached partial once

Note that this is backed by a LRU cache (which we soon shall see more usage of), so if you're a heavy user of cached partials it may be evicted and
refreshed if needed. But in most cases every partial is only invoked once.

This commit also adds a timeout (the global `timeout` config option) to make infinite recursion in partials
easier to reason about.

```
name              old time/op    new time/op    delta
IncludeCached-10    8.92ms ± 0%    8.48ms ± 1%   -4.87%  (p=0.016 n=4+5)

name              old alloc/op   new alloc/op   delta
IncludeCached-10    6.65MB ± 0%    5.17MB ± 0%  -22.32%  (p=0.002 n=6+6)

name              old allocs/op  new allocs/op  delta
IncludeCached-10      117k ± 0%       71k ± 0%  -39.44%  (p=0.002 n=6+6)
```

Closes #4086
Updates #9588

Update README.md

releaser: Prepare repository for 0.111.0-DEV

[ci skip]

releaser: Bump versions for release of 0.110.0

[ci skip]

dos: Regen CLI docs

docs: Regen docshelper

Merge commit 'ef6f101e75256c3bb88a6f1f3b5c1273bf8d7382'

Squashed 'docs/' changes from 2c0125b52..1214f6ffb

1214f6ffb Document cleanDestinationDir configuration setting
27ca65463 Clarify .Page.Param method (#1953)
3fa1792d2 Document the usage of `hardWrap` option for markdown rendering (#1951)
8b5afdfb4 Update theme
207e7f0a0 fix docs for getting remote font
1f7094b9e Correct typo
f9d6445c4 Added missing `/` in URL generator (#1946)
3a22ee7d6 Remove translations
b3b900f3f Update introduction.md
aca440052 rm Forestry - facing end-of-life shortly (#1944)
af0014e14 Update scss-sass.md
1c43bbbc9 Merge branch 'docs/goworkspace'
d034175ca netlify: Hugo 0.109.0
d3a6a5c3f Merge branch 'tempv0.109.0'
e033dbead docs: Regen docs helper JSON
452bf675c resource/page: Add Page.Ancestors
12edd7363 Add some docs for workspaces
8f0fcba6b Add HUGO_PUBLISHDIR to the Node environment
4e66d98ad Update theme
808aee6f6 config: Update to ga v4
1de2bc5a9 config: Update to ga v4
ddb5fd6b0 Merge commit '41bc6f702aa54200530efbf4267e5c823df3028d'
54c54bf76 modules: Adjust watch logic vs workspace use definitions

git-subtree-dir: docs
git-subtree-split: 1214f6ffbf680e853746aaeb6cb097b28c0c556b

related: Handly []any

See #10624

Fix permalinks issue with repeated sections

Fixes #10377

tpl/strings: Add findRESubmatch

Fixes #10594

config/security: Add O\w+ (e.g. GOROOT) to the default allowed list

Fixes #10429

Preserve front matter slice value types (e.g. int)

Fixes #10624

Make hugo.toml the new config.toml

Both will of course work, but hugo.toml will win if both are set.

We should have done this a long time ago, of course, but the reason I'm picking this up now is that my VS Code setup by default picks up some
JSON config schema from some random other software which also names its config files config.toml.

Fixes #8979

Add fill HTTP Response info into .Data in resources.GetRemote

See #10604

Fix HEAD method in resources.GetRemote

Fixes #10604

Fix order when reading custom headers in resources.GetRemote

Fixes #10616

deps: Upgrade github.com/evanw/esbuild v0.15.18 => v0.17.0

Also add a test to make sure legal comments are preserved in JS bundles.

Closes #10536

Update README.md

resource: Fix Go Doc vs .Data.Integrity

Misc doc, code refactoring to improve documentation

Make readFile return nil when file not found (note)

Fixes #9620

Remove reference to Goreleaser in code comment

Hugo no longer uses the Goreleaser tool.

tpl/compare: Sort special float values as string

When sorting strings a worng order is returned. This happens because the strings are first converted
to floating values to check whether or not they should be sorted as
floating values. When an error is returned the strings will be
handled as string literals.
No error will be returned when parsing Inf, Infinity or NaN (case insensitive) because they
will be coverted to special floating point values and therefore are
legal float values.
Now we check if the returned converted values are special floating
values and treat them as string literals.

Fixes #10389

tpl/diagrams: Move Goat to its own file

Update CONTRIBUTING.md

Update CONTRIBUTING.md

Update README.md

releaser: Prepare repository for 0.110.0-DEV

[ci skip]

releaser: Bump versions for release of 0.109.0

[ci skip]

Adjust "you need the extended version" error message

docs: Regen docs helper JSON

resource/page: Slight adjustment of Page.Ancestors

Fixes #10567

resource/page: Add Page.Ancestors

Fixes #10567

build(deps): bump golang.org/x/tools from 0.3.0 to 0.4.0

Bumps [golang.org/x/tools](https://github.com/golang/tools) from 0.3.0 to 0.4.0.
- [Release notes](https://github.com/golang/tools/releases)
- [Commits](https://github.com/golang/tools/compare/v0.3.0...v0.4.0)

---
updated-dependencies:
- dependency-name: golang.org/x/tools
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

Annotate test assertions

hugolib: Exclude non-linkable pages from translations map

Fixes #9073

Add HUGO_PUBLISHDIR to the Node environment

So you can do  `process.env.HUGO_PUBLISHDIR` in your `postcss.config.js` to figure out where Hugo publishes
its files.

Note that the value will always be an absolute file path and will point to a directory on disk even when running `hugo server` in memory mode.

If you write to this folder from PostCSS when running the server, you could run the server with one of these flags:

```
hugo server --renderToDisk
hugo server --renderStaticToDisk
```

Fixes #10554

Revert "tpl/tplimpl: Use https in sitemap templates"

This reverts commit 3fd0b78498597ceb343b7fda2e9b652f3e957478.

tpl: Improve template funcs GoDoc

tpl/resources: Fix data race in ToCSS

Fixes #10542

tocss: Add some more test cases

See #10555

tocss: Fix unquote case with double quotes

See #10555

Allow "fast render mode" even if --disableLiveReload is set

Fixes #10561

tocss: Add vars option

This commit adds a new `vars` option to both the Sass transpilers (Dart Sass and Libsass).

This means that you can pass a map with key/value pairs to the transpiler:

```handlebars
{{ $vars := dict "$color1" "blue" "$color2" "green" "$font_size" "24px" }}
{{ $cssOpts := (dict "transpiler" "dartsass" "outputStyle" "compressed" "vars" $vars ) }}
{{ $r := resources.Get "scss/main.scss" |  toCSS $cssOpts }}
```

And the the variables will be available in the `hugo:vars` namespace. Example usage for Dart Sass:

```scss
@use "hugo:vars" as v;

p {
    color: v.$color1;
    font-size: v.$font_size;
}
```

Note that Libsass does not support the `use` keyword, so you need to `import` them as global variables:

```scss
@import "hugo:vars";

p {
    color: $color1;
    font-size: $font_size;
}
```

Hugo will:

* Add a missing leading `$` for the variable names if needed.
* Wrap the values in `unquote('VALUE')` (Sass built-in) to get proper handling of identifiers vs other strings.

This means that you can pull variables directly from e.g. the site config:

```toml
[params]
[params.sassvars]
color1 = "blue"
color2 = "green"
font_size = "24px"
image = "images/hero.jpg"
```

```handlebars
{{ $vars := site.Params.sassvars}}
{{ $cssOpts := (dict "transpiler" "dartsass" "outputStyle" "compressed" "vars" $vars ) }}
{{ $r := resources.Get "scss/main.scss" |  toCSS $cssOpts }}
```

Fixes #10555

Squashed 'docs/' changes from 2201ac0e5..2c0125b52

2c0125b52 Remove .Site.Author
2cf8841b3 Update partialCached.md (#1924)
385487191 Update data-templates.md (#1926)
ce207e141 Remove redundant markdown and fix a few typos (#1936)
3687c2953 Make heading id linkable, take 2
45c79bea7 Make heading id linkable
b22079344 Delete duplicates the lines 557-569 and 570-582. (#1934)
0a90dc122 Rework the taxonomy variables page (#1935)
7f8979c50 Update theme
26e682a3a Update multilingual.md
d40e7693f Update postcss.md
375d75c01 Update postcss npm instructions (#1931)
63020094a Emphasize Window shell selection (#1930)
56824be2c Update configuration.md
b7b8f16b3 Docu 'Theme components': minor fix (#1929)
09dc81a05 Remove Docker from BSD page (#1927)
205fea204 netlify: Hugo 0.108.0
6abe49c28 Merge commit 'da670c38ee63a7fef25e2b9f42519232055b60dc'
12b59a4c5 docs: Add basic doc for wrapStandAloneImageWithinParagraph etc.
ba07bd970 dartsass: Add sourceMapIncludeSources option

git-subtree-dir: docs
git-subtree-split: 2c0125b5290494d49334606c451446ebd9df3c21

Merge commit '41bc6f702aa54200530efbf4267e5c823df3028d'

modules: Improve "module workspace" not found error

modules: Adjust watch logic vs workspace use definitions

Add any configured Go Workspace file to the config watcher

Fixes #10556

modules: Make the module.workspace=off as default (note)

Also, resolve any workspace file relative to the workingDir.

Fixes #10553

release: Add a note section in release notes

helpers: Allow at signs in UnicodeSanitize (note)

Closes #10548

parser/metadecoders: Remove superflous cast in test

parser/metadecoders: Simplify nil check in Unmarshal

parser/metadecoders: Add empty /data JSON file as empty map

When fetching JSON files from the /data folder that are empty they will
be added as empty map[string]any. This makes sure that no empty JSON
file causes the site to crash because of a failed unmarshal. This
happens because empty is not a valid JSON string. It is therefore
important to check the lenght of the data before passing it to the JSON
unmarshal function.

Fixes #8601

Also consider wrapped errors when checking for file IsNotExist errors

Fixes #10534

tpl/openapi3: Wrap *kopenapi3.T

To make it easier to document.

resources/js: Fix some import discrepancies between Hugo and ESBuild

This fixes the cases where

```js
import 'imp2/index.js';
import 'imp3/foo.js';
```

And these files lives in `assets` as:

```
imp2/index.ts
imp3/foo.ts
```

Fixes #10527

github: Update to Dart Sass 1.56.2

github: Use ruby/setup-ruby

Closes #10517

tpl/tplimpl: Use https in sitemap templates

Closes #10515

parser/metadecoders: Fix spelling

releaser: Prepare repository for 0.109.0-DEV

[ci skip]

releaser: Bump versions for release of 0.108.0

[ci skip]

Make the hugo env non verbose output slightly more verbose

This is how it may look like with a extended build:

```
hugo v0.107.0-6445b1e9ff963b07c55d9d69cb9abef8ef21fc5d+extended darwin/arm64 BuildDate=2022-12-06T11:21:50Z
GOOS="darwin"
GOARCH="arm64"
GOVERSION="go1.19.3"
github.com/sass/libsass="3.6.5"
github.com/webmproject/libwebp="v1.2.4"
github.com/sass/dart-sass-embedded/protocol="1.1.0"
github.com/sass/dart-sass-embedded/compiler="1.56.1"
github.com/sass/dart-sass-embedded/implementation="1.56.1"
```

Add dart-sass-embedded version info to hugo env -v

```
~ ❯❯❯ hugo env -v | grep dart
github.com/bep/godartsass="v0.16.0"
github.com/sass/dart-sass-embedded/compiler="1.56.1"
github.com/sass/dart-sass-embedded/implementation="1.56.1"
github.com/sass/dart-sass-embedded/protocol="1.1.0"
```

deps: Upgrade github.com/bep/godartsass v0.15.0 => v0.16.0

tpl/embedded: Make Open Graph's series optional

Squashed 'docs/' changes from 4c1309cdf..2201ac0e5

2201ac0e5 Update theme

git-subtree-dir: docs
git-subtree-split: 2201ac0e5fa47400ecd182e28af823e0f03ed05b

Merge commit 'da670c38ee63a7fef25e2b9f42519232055b60dc'

common/hugio: Fix multiWriteCloser.Close

Fixes #10505

build(deps): bump github.com/getkin/kin-openapi from 0.109.0 to 0.110.0

Bumps [github.com/getkin/kin-openapi](https://github.com/getkin/kin-openapi) from 0.109.0 to 0.110.0.
- [Release notes](https://github.com/getkin/kin-openapi/releases)
- [Commits](https://github.com/getkin/kin-openapi/compare/v0.109.0...v0.110.0)

---
updated-dependencies:
- dependency-name: github.com/getkin/kin-openapi
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

docs: Add basic doc for wrapStandAloneImageWithinParagraph etc.

See #10492

dartsass: Add sourceMapIncludeSources option