all: Fix comments for exported functions and packages

deps: Update github.com/bep/golibsass v1.1.0 => v1.1.1

Fixes #10629
Fixes #10491

Make GOMAXPROCS to be CPU limit aware

Fixes #10950

Allow empty params.mainSections

Updates #10953

modules: Fix format flag in error

commands: Load config before creating the filesystem

To allow publishDir to be set in config file.

Fix some recently introduced error handling issues

Updates #10953

tpl/lang: document delimiter option for FormatNumberCustom

Closes gohugoio/hugoDocs#1760

Re-add site.LanguagePrefix

Updates #10947

github: Trim the test flow a little

We now have much improved end to end tests, so cut the building of the docs site to save some time of the PR builds.

commands: Improve the common build flag handling

Updates #10947

Support, but warn, about top level language custom params

Updates #10947

Handle transient errors in config loading etc.

As in: Get the Kubernetes site to build with the new Hugo version.

Updates #10947

Re-establish all the server flags

Updates #10947

Deprecate site.Language.Params and some other fixes

Updates #10947

Revert "Make GOMAXPROCS CPU limit aware"

I shouldn't have merged this without running the tests.

This libray logs to stderr on init, which is a no go for us.

Re. test failure:

```
[stderr]
2023/05/17 18:21:04 maxprocs: Leaving GOMAXPROCS=2: CPU quota undefined
```
This reverts commit 59050f97f637b7cb423e6f5b63e36c1ea973c183.

Make GOMAXPROCS CPU limit aware

Fixes #10950

Add Sections to Site interface

See https://github.com/gohugoio/hugo/issues/10947#issuecomment-1550012671

Updates #10947

helpers: simplify path tests with T.TempDir

tpl: Add math.Abs

Fixes #10941.

Create a struct with all of Hugo's config options

Primary motivation is documentation, but it will also hopefully simplify the code.

Also,

* Lower case the default output format names; this is in line with the custom ones (map keys) and how
it's treated all the places. This avoids doing `stringds.EqualFold` everywhere.

Closes #10896
Closes #10620

Improve date parsing performance for the common case

```
name                    old time/op    new time/op    delta
Baseline/skiprender-10    24.5ms ±10%    22.3ms ± 4%   -8.93%  (p=0.029 n=4+4)

name                    old alloc/op   new alloc/op   delta
Baseline/skiprender-10    30.0MB ± 0%    26.2MB ± 0%  -12.74%  (p=0.029 n=4+4)

name                    old allocs/op  new allocs/op  delta
Baseline/skiprender-10      373k ± 0%      279k ± 0%  -25.07%  (p=0.029 n=4+4)
```

Fixes #10942

Add a counter helper

Expand the baseline benchmark a little

Revert "Update syntax-highlighting.md (#10929)" (#10930)

This reverts commit a4fb8dc6bc4358ca5c307e1af4a50fee2a0c4c12.

Update syntax-highlighting.md (#10929)

Update README.md

tpl/strings: Clarify findRESubmatch description

langs/i18n: Fallback to defaultContentLanguage instead of English

Co-authored-by: 641bill <wo23636@126.com>
Fixes #9216

tpl/debug: Add VisualizeSpaces

Update README.md

Prevent the global error collector to panic when sending on closed channel

markup/goldmark: Add config options for the typographer extension

Note that the config per language part of this will be handled in #10602.

Updates #9772

readme: Fix build command

Update README.md

Add test for ToC vs include

See #10866

resources.functions: improve validation

resources: Fix typos in error message and variables

markup/goldmark: Fail on invalid Markdown attributes

commands: Fix data race in test

Note that this is a test fix only.

tpl/math: Return error if less than 2 input numbers

Fixes #10827

releaser: Prepare repository for 0.112.0-DEV

[ci skip]

releaser: Bump versions for release of 0.111.3

[ci skip]

deps: Update go-org to v1.6.6

among other things, fixes a race condition in html writer and bug preventing
explicit line breaks immediately following emphasis

Fix "unknown shortcode token" when calling shortcode within fenced code block

Fixes #10819

Run gofmt -s on source files

docs: Improve examples of variadic math functions

tpl/math: Allow multi numbers in add, sub, mul, div, min and max

readme: Update dependency list

Improve error message for unclosed shortcode with inner content

Don't fail when calling Paginate with an empty pages.PagesGroup

Fixes #10802

server: Replace golang.org/x/net/context with context

tpl: Add hasSuffix alias

strings.HasPrefix already has an alias of hasPrefix
but strings.HasSuffix has no such alias.
This PR adds a hasSuffix alias to the tpl function with corresponding
function documentation.
It also adds a Minor update to the hasPrefix function documentation
re: keywords and relatedfuncs.

 Completes https://github.com/gohugoio/hugo/issues/10474

watcher: use time.NewTicker to prevent leaks

Replace time.Tick with time.NewTicker.

ensure we default to 10 correctly

switch transfers to workers

customize parallel transfer count

metadecoders: Add support for native org dates in frontmatter
PR #7433 added support for Org timestamps for the DATE header. This PR widens the support with additional front matter headers LASTMOD, PUBLISHDATE and EXPIRYDATE.

Fixes #8536

releaser: Prepare repository for 0.112.0-DEV

[ci skip]

releaser: Bump versions for release of 0.111.2

[ci skip]

Fix .Fragments when called cross sites on uninitialized output format

Fixes #10794

Allow page.TableOfContents on self in shortcode

Fixes #10791

tpl/partial: Consolidate GoDoc

Fix "context canceled" with partial

Make sure the context used for timeouts isn't created based on the incoming
context, as we have cases where this can cancel the context prematurely.

Fixes #10789

cache: Fix --gc failure on Windows

Fixes "Error: failed to prune cache" on Windows and removes
work around from ec1c97e7e9d62ce5245135e0906fdedf14af0cae.

Follows #10781.

Page context handling in i18n

This is a workaround. We need to improve on this, but not today.

Fixes #10782

Work around --gc failure on Windows <= 10

This applies two related fixes/improvements:

* The --gc now keeps empty `_resources/_gen/images` etc folders, even if empty. This should have been the behaviour
from the start.
* Also, if removal of an empty dir on Windows fails with the "used by another process" error, just ignore it for now.

Fixes #10781

Update to Go 1.20.1

Fixes #10785

snap: Fix dart-sass-embedded installation

Closes #10783

Correct typos in Go comments

releaser: Prepare repository for 0.112.0-DEV

[ci skip]

releaser: Bump versions for release of 0.111.1

[ci skip]

Merge branch 'release-0.111.0'

Fix "page" not defined

Fixes #10774

releaser: Prepare repository for 0.112.0-DEV

[ci skip]

releaser: Bump versions for release of 0.111.0

[ci skip]

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

This reverts commit c3a59a7d5a53eff9723861d0c4b18a574e2769bc.

See #10770

build: Bump build images

To fix changed Shuffle behaviour on Go 1.20.

build: Update Linux ARM build image

tpl/tplimpl: Remove the Google News internal template

This was deprecated, with a warning message, on 21 Nov 2021.

Reference #9190

strings: fix Truncate behavior for formatted html

Before this fix, strings.Truncate would erroneously re-include
attributes from the opening tag in the closing tag when closing
formatted html, due to a bug in how tagnames were extracted from the
regex capture group for html tags used in `truncate.go`. This change
ensures that only the tagname is retained and all attributes are discarded
when storing the tags for closing them later.

Fixes #10399

tpl/strings: Adjust benchmark

tpl/strings: Add BenchmarkTruncate

cods: Regen docs helper

Move the Related doc counter to prevent a race

Closes #10768

Misc ioutil deprecation adjustments

To make the tests pass.

* Replace io => os.ReadFile in magefile.go
* Adjust failing image test vs fs.DirEntry
* Adjust poller test

See #10732

Replace deprecated ioutil with io and os

https://pkg.go.dev/io/ioutil is deprecated since Go 1.16.

Merge commit '336622d5e7afd9334cd2de7150d4f16bdf7c24f9'

Squashed 'docs/' changes from 36dd5483f..6e32d0591

6e32d0591 Update quick-start.md (#1984)
eddd25ff4 Mermaid: reflect latest docs specifications
b2a23b6f5 Mermaid: switch to ESM import
43d83c131 Update index.md

git-subtree-dir: docs
git-subtree-split: 6e32d05910fb9d623ef26b647def10ea0e00cd15

build(deps): bump github.com/tdewolff/parse/v2 from 2.6.4 to 2.6.5

Bumps [github.com/tdewolff/parse/v2](https://github.com/tdewolff/parse) from 2.6.4 to 2.6.5.
- [Release notes](https://github.com/tdewolff/parse/releases)
- [Commits](https://github.com/tdewolff/parse/compare/v2.6.4...v2.6.5)

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

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

build(deps): bump github.com/mattn/go-isatty from 0.0.16 to 0.0.17

Bumps [github.com/mattn/go-isatty](https://github.com/mattn/go-isatty) from 0.0.16 to 0.0.17.
- [Release notes](https://github.com/mattn/go-isatty/releases)
- [Commits](https://github.com/mattn/go-isatty/compare/v0.0.16...v0.0.17)

---
updated-dependencies:
- dependency-name: github.com/mattn/go-isatty
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

build(deps): bump golang.org/x/image

Bumps [golang.org/x/image](https://github.com/golang/image) from 0.0.0-20211028202545-6944b10bf410 to 0.5.0.
- [Release notes](https://github.com/golang/image/releases)
- [Commits](https://github.com/golang/image/commits/v0.5.0)

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

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

Remove unused temp directory

exif: Return the proper exposure time value in some special cases

Return value in float64 if exposure time is int or greater than 1, otherwise return in fraction.

Fixes #10738

Add a page template func

Fixes #9339

dartsass: Import CSS without extension at compile time

Applicable to Dart Sass only:

- Sass imports with the .css extension indicate a plain CSS @import.
- Sass imports without the .css extension are imported at compile time.

Fixes #10592

Split parse and render for Goldmark

This also speeds up situations where you only need the fragments/toc and not the rendered content, e.g. Related
with fragments type indexing:

```bash

name            old time/op    new time/op    delta
RelatedSite-10    12.3ms ± 2%    10.7ms ± 1%  -12.95%  (p=0.029 n=4+4)

name            old alloc/op   new alloc/op   delta
RelatedSite-10    38.6MB ± 0%    38.2MB ± 0%   -1.08%  (p=0.029 n=4+4)

name            old allocs/op  new allocs/op  delta
RelatedSite-10      117k ± 0%      115k ± 0%   -1.36%  (p=0.029 n=4+4)
```

Fixes #10750

related: Add config option cardinalityThreshold

Fixes #10744

 docs: Another fix related docs example

docs: Fix related docs example