More updates for v0.123.00

content/en/content-management/diagrams.md

@@ -6,8 +6,8 @@ keywords: [diagrams,drawing]
 menu:
   docs:
     parent: content-management
-    weight: 245
-weight: 245
+    weight: 260
+weight: 260
 toc: true
 ---
 {{< new-in 0.93.0 >}}

content/en/content-management/front-matter.md

@@ -36,8 +36,7 @@ date = 2024-02-02T04:14:54-08:00
 draft = false
 weight = 10
 [params]
-myparam = 42
-tags = ['red','blue']
+author = 'John Smith'
 {{< /code-toggle >}}
 
 Front matter fields may be [scalar], [arrays], or [maps] containing [boolean], [integer], [float], or [string] values. Note that the TOML format also supports date/time values using unquoted strings.
@@ -262,23 +261,50 @@ path
 
 ## Parameters
 
-Specify custom page parameters, including taxonomy terms, under the `params` key in front matter:
+Specify custom page parameters under the `params` key in front matter:
 
 {{< code-toggle file=content/example.md fm=true >}}
 title = 'Example'
 date = 2024-02-02T04:14:54-08:00
 draft = false
 weight = 10
 [params]
-myparam = 42
-tags = ['red','blue']
+author = 'John Smith'
 {{< /code-toggle >}}
 
 Access these values from a template using the [`Params`] or [`Param`] method on a `Page` object.
 
 [`param`]: /methods/page/param/
 [`params`]: /methods/page/params/
 
+## Taxonomies
+
+Classify content by adding taxonomy terms to front matter. For example, with this site configuration:
+
+{{< code-toggle file=hugo >}}
+[taxonomies]
+tag = 'tags'
+genre = 'genres'
+{{< /code-toggle >}}
+
+Add taxonomy terms as shown below:
+
+{{< code file=content/example.md >}}
+title = 'Example'
+date = 2024-02-02T04:14:54-08:00
+draft = false
+weight = 10
+tags = ['red','blue']
+genres = ['mystery','romance']
+[params]
+author = 'John Smith'
+{{< /code >}}
+
+Access taxonomy terms from a template using the [`Params`] or [`GetTerms`] method on a `Page` object:
+
+[`Params`]: /methods/page/params/
+[`GetTerms`]: /methods/page/getterms/
+
 ## Cascade
 
 Any [node] can pass down to its descendants a set of front matter values.
@@ -356,7 +382,9 @@ If your [content format] is [Emacs Org Mode], you may provide front matter using
 #+TITLE: Example
 #+DATE: 2024-02-02T04:14:54-08:00
 #+DRAFT: false
-#+MYPARAM: 42
+#+AUTHOR: John Smith
+#+GENRES: mystery
+#+GENRES: romance
 #+TAGS: red
 #+TAGS: blue
 #+WEIGHT: 10

content/en/content-management/markdown-attributes.md

@@ -0,0 +1,115 @@
+---
+title: Markdown attributes
+description: Use mardown attributes to add HTML attributes when rendering markdown to HTML.
+categories: [content management]
+keywords: [goldmark,markdown]
+menu:
+  docs:
+    parent: content-management
+    weight: 240
+weight: 240
+toc: true
+---
+
+## Overview
+
+Hugo supports markdown attributes on images and block elements including blockquotes, fenced code blocks, headings, horizontal rules, lists, paragraphs, and tables.
+
+For example:
+
+```text
+This is a paragraph.
+{class="foo bar" id="baz"}
+```
+
+With `class` and `id` you can use shorthand notation:
+
+```text
+This is a paragraph.
+{.foo .bar #baz}
+```
+
+Hugo renders both of these to:
+
+```html
+<p class="foo bar" id="baz">This is a paragraph.</p>
+```
+
+## Block elements
+
+Update your site configuration to enable markdown attributes for block-level elements.
+
+{{< code-toggle file=hugo >}}
+[markup.goldmark.parser.attribute]
+title = true # default is true
+block = true # default is false
+{{< /code-toggle >}}
+
+
+## Standalone images
+
+By default, when the [Goldmark] markdown renderer encounters a standalone image element (no other elements or text on the same line), it wraps the image element within a paragraph element per the [CommonMark specification].
+
+[CommonMark specification]: https://spec.commonmark.org/current/
+[Goldmark]: https://github.com/yuin/goldmark
+
+If you were to place an attribute list beneath an image element, Hugo would apply the attributes to the surrounding paragraph, not the image.
+
+To apply attributes to a standalone image element, you must disable the default wrapping behavior:
+
+{{< code-toggle file=hugo >}}
+[markup.goldmark.parser]
+wrapStandAloneImageWithinParagraph = false # default is true
+{{< /code-toggle >}}
+
+## Usage
+
+You may add [global HTML attributes], or HTML attributes specific to the current element type. Consistent with its content security model, Hugo removes HTML event attributes such as `onclick` and `onmouseover`.
+
+[global HTML attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes
+
+The attribute list consists of one or more key/value pairs, separated by spaces or commas, wrapped by braces. You must quote string values that contain spaces. Unlike HTML, boolean attributes must have both key and value.
+
+For example:
+
+```text
+> This is a blockquote.
+{class="foo bar" hidden=hidden}
+```
+
+Hugo renders this to:
+
+```html
+<blockquote class="foo bar" hidden="hidden">
+  <p>This is a blockquote.</p>
+</blockquote>
+```
+
+In most cases, place the attribute list beneath the markup element. For headings and fenced code blocks, place the attribute list on the right.
+
+Element|Position of attribute list
+:--|:--
+blockquote | bottom
+fenced code block | right
+heading | right
+horizontal rule | bottom
+image | bottom
+list  | bottom
+paragraph | bottom
+table | bottom
+
+For example:
+
+````text
+## Section 1 {class=foo}
+
+```bash {class=foo linenos=inline}
+declare a=1
+echo "${a}"
+```
+
+This is a paragraph.
+{class=foo}
+````
+
+As shown above, the attribute list for fenced code blocks is not limited to HTML attributes. You can also configure syntax highlighting by passing one or more of [these options](/functions/transform/highlight/#options).

content/en/content-management/mathematics.md

@@ -7,8 +7,8 @@ keywords: [chemical,chemistry,latex,math,mathjax,tex,typesetting]
 menu:
   docs:
     parent: content-management
-    weight: 250
-weight: 250
+    weight: 270
+weight: 270
 toc: true
 math: true
 ---

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

@@ -6,8 +6,8 @@ keywords: [highlighting,chroma,code blocks,syntax]
 menu:
   docs:
     parent: content-management
-    weight: 240
-weight: 240
+    weight: 250
+weight: 250
 toc: true
 aliases: [/extras/highlighting/,/extras/highlight/,/tools/syntax-highlighting/]
 ---

content/en/functions/go-template/return.md

@@ -80,7 +80,7 @@ See additional examples in the [partial templates] section.
 ## Usage
 
 {{% note %}}
-Unlike `return` statements in other languages, Hugo executes the first occurrence of the `return` statement regardless of its position within logical blocks
+Unlike `return` statements in other languages, Hugo executes the first occurrence of the `return` statement regardless of its position within logical blocks.
 {{% /note %}}
 
 A partial that returns a value must contain only one `return` statement, placed at the end of the template.