Changes required for v0.123.0

[jmooring]

1) ✔️ https://gohugo.io/methods/site/sites/

See gohugoio/hugo#11860. Change this:

Returns a collection of all Site objects, one for each language, ordered by language weight.

to this:

Returns a collection of all Site objects, one for each language, ordered by default content language then by language weight.

2) ✔️ https://gohugo.io/content-management/page-bundles/

See gohugoio/hugo#11439. Change this:

Only in the directory level of the branch bundle directory i.e. the directory containing the _index.md (ref).

to this:

At any directory level within the branch bundle directory.

3) ✔️ https://gohugo.io/methods/site/lastchange/

See gohugoio/hugo#11457. Mark as deprecated, add new page methods/site/lastmod.

4) ✔️ https://gohugo.io/methods/page/bundletype/

.Page.BundleType() return type changed to string (the old internal string type is removed)

5) ✔️ https://gohugo.io/functions/data/getcsv/

See gohugoio/hugo#11932. Deprecate in favor of using page or global resources with transform.Unmarshal.

6) ✔️ https://gohugo.io/functions/data/getjson/

See gohugoio/hugo#11932. Deprecate in favor of using page or global resources with transform.Unmarshal.

7) ✔️ New fmt.Warnidf function

See gohugoio/hugo@098a0ce

8) ✔️ Rename config ignoreErrors => ignoreLogs

See gohugoio/hugo@098a0ce

9) ✔️ https://gohugo.io/templates/output-formats/

See gohugoio/hugo#11551.

See gohugoio/hugo#8927.

10) ✔️ https://gohugo.io/troubleshooting/faq/

See gohugoio/hugo#11809.

11) ✔️ Remove .Page.File.Lang (deprecated)

12) ✔️ Remove usage of .Page.Lang in examples

13) ✔️ Add .Page.File.Section

14) ✔️ Add .Page.Path

15) ✔️ Params key in front matter

• https://gohugo.io/methods/page/param/
• https://gohugo.io/methods/page/params/
• https://gohugo.io/templates/introduction/#use-content-page-parameters

When updating the front matter fields list, do not document the kind, path, or lang front matter fields at this time; they are for future use.

See:

• Add the [params] concept to front matter hugo#11934
• Misc fixes and improvements hugo#11940

16) ✔️ Add something, somewhere about default render hooks

• See Create default link and image render hooks hugo#11933.
• The existing render hooks page almost needs to be its own section, with one page for each type of render hook. There are default render hooks for images, links, and GoAT code blocks.
• Need to include Goldmark config for default link and image render hooks (how to enable).

[markup.goldmark.renderHooks.image]
  enableDefault = false
[markup.goldmark.renderHooks.link]
  enableDefault = false

17) ✔️ Remove/replace deprecated calls in github.com/gohugoio/gohugoioTheme

• data.GetJSON
• .Page.Lang

18) ✔️ Remove deprecated calls from Hugo's built-in templates

gohugoio/hugo#11971

19) ✔️ Update instagram usage docs per changes in gohugoio/hugo#11971

20) ✔️ https://gohugo.io/content-management/multilingual/#page-bundles

See gohugoio/hugo#11453. For multilingual sites, "shared" page resources are no longer accessible via markdown link/image elements without render hooks designed for portability.

Document:

[markup.goldmark]
duplicateResourceFiles = false

[cmahnke]

Two additions:

• Nil pointer error instead of warning when checking .File.Something without a backing file
  Maybe as a part of a section o upgrading? (Related to 14?)
• Consider _build vs build
  What ever the final field name might be, there should be advice / convention like "Avoid adding front matter fields starting with underscore" or "Avoid adding custom front matter fields, use the new params key instead" (15)

[jmooring]

Nil pointer error instead of warning when checking .File.Something without a backing file

This is no longer relevant with hugo v0.123.0-DEV-28733248 and later.

Error: error building site: render: failed to render pages: render of "home" failed: "/home/jmooring/code/hugo-testing/layouts/_default/home.html:16:10": execute of template failed: template: _default/home.html:16:10: executing "main" – File is nil; wrap it in if or with: {{ with .File }}{{ .Path }}{{ end }}

---

Consider _build vs build

Done.