diff options
author | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2023-02-23 07:52:04 +0100 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2023-02-23 07:52:04 +0100 |
commit | 7e539cb398d8fa3cb17eba7b8ab4ba88b8e9c2ef (patch) | |
tree | 25017e060b2e840e575e962b6c5964a9b347864e /docs/content/en/functions | |
parent | 586fea0de6ea3d389ec6ccc893bdafcf3bc569a0 (diff) | |
parent | cf591b7c0c598d34896709db6d28598da37e3ff6 (diff) |
Merge commit 'cf591b7c0c598d34896709db6d28598da37e3ff6'
Diffstat (limited to 'docs/content/en/functions')
-rw-r--r-- | docs/content/en/functions/dict.md | 2 | ||||
-rw-r--r-- | docs/content/en/functions/findRe.md | 19 | ||||
-rw-r--r-- | docs/content/en/functions/format.md | 4 | ||||
-rw-r--r-- | docs/content/en/functions/highlight.md | 10 | ||||
-rw-r--r-- | docs/content/en/functions/markdownify.md | 5 | ||||
-rw-r--r-- | docs/content/en/functions/uniq.md | 19 | ||||
-rw-r--r-- | docs/content/en/functions/urls.Parse.md | 2 |
7 files changed, 37 insertions, 24 deletions
diff --git a/docs/content/en/functions/dict.md b/docs/content/en/functions/dict.md index 5c8ad9d8a..dd1e2cd5b 100644 --- a/docs/content/en/functions/dict.md +++ b/docs/content/en/functions/dict.md @@ -31,7 +31,7 @@ The partial below creates an SVG and expects `fill`, `height` and `width` from t ### Partial definition {{< code file="layouts/partials/svgs/external-links.svg" download="external-links.svg" >}} -<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" +<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" fill="{{ .fill }}" width="{{ .width }}" height="{{ .height }}" viewBox="0 0 32 32" aria-label="External Link"> <path d="M25.152 16.576v5.696q0 2.144-1.504 3.648t-3.648 1.504h-14.848q-2.144 0-3.648-1.504t-1.504-3.648v-14.848q0-2.112 1.504-3.616t3.648-1.536h12.576q0.224 0 0.384 0.16t0.16 0.416v1.152q0 0.256-0.16 0.416t-0.384 0.16h-12.576q-1.184 0-2.016 0.832t-0.864 2.016v14.848q0 1.184 0.864 2.016t2.016 0.864h14.848q1.184 0 2.016-0.864t0.832-2.016v-5.696q0-0.256 0.16-0.416t0.416-0.16h1.152q0.256 0 0.416 0.16t0.16 0.416zM32 1.152v9.12q0 0.48-0.352 0.8t-0.8 0.352-0.8-0.352l-3.136-3.136-11.648 11.648q-0.16 0.192-0.416 0.192t-0.384-0.192l-2.048-2.048q-0.192-0.16-0.192-0.384t0.192-0.416l11.648-11.648-3.136-3.136q-0.352-0.352-0.352-0.8t0.352-0.8 0.8-0.352h9.12q0.48 0 0.8 0.352t0.352 0.8z"></path> </svg> diff --git a/docs/content/en/functions/findRe.md b/docs/content/en/functions/findRe.md index 8e08bfc0d..13d43f896 100644 --- a/docs/content/en/functions/findRe.md +++ b/docs/content/en/functions/findRe.md @@ -36,5 +36,24 @@ To limit the number of matches to one: You can write and test your regular expression using [regex101.com](https://regex101.com/). Be sure to select the Go flavor before you begin. {{% /note %}} +## findRESubmatch + +In Hugo 0.110.0 we added a variant of `findRe` that returns a slice of strings holding the text of the leftmost match of the regular expression in s and the matches, if any, of its subexpressions. + +This: + +```go-html-template +{{ findRESubmatch §§<a\s*href="(.+?)">(.+?)</a>§§ §§<li><a href="#foo">Foo</a></li> <li><a href="#bar">Bar</a></li>§§ | print | safeHTML }} +``` + +Will print: + +``` +[[<a href=\"#foo\">Foo</a> #foo Foo] [<a href=\"#bar\">Bar</a> #bar Bar]] +``` + +{{< new-in "0.110.0" >}} + + [RE2]: https://github.com/google/re2/wiki/Syntax [string literal]: https://go.dev/ref/spec#String_literals diff --git a/docs/content/en/functions/format.md b/docs/content/en/functions/format.md index e2f93f1fc..5c86714fe 100644 --- a/docs/content/en/functions/format.md +++ b/docs/content/en/functions/format.md @@ -95,10 +95,10 @@ More examples can be found in Go's [documentation for the time package][timecons Spelled-out cardinal numbers (e.g. "one", "two", and "three") are not currently supported. -Ordinal abbreviations (i.e., with shorted suffixes like "1st", "2nd", and "3rd") are not currently directly supported. By using `{{.Date.Format "Jan 2nd 2006"}}`, Hugo assumes you want to append `nd` as a string to the day of the month. However, you can chain functions together to create something like this: +Use the [`humanize`](/functions/humanize) function to render the day of the month as an ordinal number: ``` -{{ .Date.Format "2" }}{{ if in (slice 1 21 31) .Date.Day}}st{{ else if in (slice 2 22) .Date.Day}}nd{{ else if in (slice 3 23) .Date.Day}}rd{{ else }}th{{ end }} of {{ .Date.Format "January 2006" }} +{{ humanize .Date.Day }} of {{ .Date.Format "January 2006" }} ``` This will output: diff --git a/docs/content/en/functions/highlight.md b/docs/content/en/functions/highlight.md index 8324edb81..10b1c2d90 100644 --- a/docs/content/en/functions/highlight.md +++ b/docs/content/en/functions/highlight.md @@ -36,19 +36,19 @@ Display a number at the beginning of each line. lineNumbersInTable : Boolean. Default is `true`.\ -Render the highlighted code in an HTML table with two cells. The left table cell contains the line numbers. The right table cell contains the code, allowing a user to select and copy the code without line numbers. Irrelevant if `lineNos` is false. +Render the highlighted code in an HTML table with two cells. The left table cell contains the line numbers. The right table cell contains the code, allowing a user to select and copy the code without line numbers. Irrelevant if `lineNos` is `false`. anchorLineNos : Boolean. Default is `false`.\ -Render each line number as an HTML anchor element, and set the `id` attribute of the surrounding `<span>` to the line number. Irrelevant if `lineNos` is false. +Render each line number as an HTML anchor element, and set the `id` attribute of the surrounding `<span>` to the line number. Irrelevant if `lineNos` is `false`. lineAnchors : String. Default is `""`.\ -When rendering a line number as an HTML anchor element, prepend this value to the `id` attribute of the surrounding `<span>`. This provides unique `id` attributes when a page contains two or more code blocks. Irrelevant if `lineNos` or `anchorLineNos` is false. +When rendering a line number as an HTML anchor element, prepend this value to the `id` attribute of the surrounding `<span>`. This provides unique `id` attributes when a page contains two or more code blocks. Irrelevant if `lineNos` or `anchorLineNos` is `false`. lineNoStart : Integer. Default is `1`.\ -The number to display at the beginning of the first line. Irrelevant if `lineNos` is false. +The number to display at the beginning of the first line. Irrelevant if `lineNos` is `false`. hl_Lines : String. Default is `""`.\ @@ -68,7 +68,7 @@ Use inline CSS styles instead of an external CSS file. To use an external CSS fi tabWidth : Integer. Default is `4`.\ -Substitute this number of spaces for each tab character in your highlighted code. +Substitute this number of spaces for each tab character in your highlighted code. Irrelevant if `noClasses` is `false`. guessSyntax : Boolean. Default is `false`.\ diff --git a/docs/content/en/functions/markdownify.md b/docs/content/en/functions/markdownify.md index b42e045e7..8d8726cff 100644 --- a/docs/content/en/functions/markdownify.md +++ b/docs/content/en/functions/markdownify.md @@ -4,7 +4,7 @@ linktitle: markdownify description: Runs the provided string through the Markdown processor. date: 2017-02-01 publishdate: 2017-02-01 -lastmod: 2017-02-01 +lastmod: 2023-02-09 keywords: [markdown,content] categories: [functions] menu: @@ -23,6 +23,7 @@ aliases: [] {{ .Title | markdownify }} ``` -{{< new-in "0.93.0" >}} **Note**: `markdownify` now supports [Render Hooks] just like [.RenderString](/functions/renderstring/). +{{< new-in "0.93.0" >}} **Note**: `markdownify` now supports [Render Hooks] just like [`.Page.RenderString`]. However, if you use more complicated [Render Hooks] relying on page context, use [`.Page.RenderString`] instead. See [GitHub issue #9692](https://github.com/gohugoio/hugo/issues/9692) for more details. [Render Hooks]: /templates/render-hooks/ +[`.Page.RenderString`]: /functions/renderstring/ diff --git a/docs/content/en/functions/uniq.md b/docs/content/en/functions/uniq.md index eec55e5c3..73ca32488 100644 --- a/docs/content/en/functions/uniq.md +++ b/docs/content/en/functions/uniq.md @@ -1,25 +1,18 @@ --- title: uniq linktitle: uniq -description: Takes in a slice or array and returns a slice with subsequent duplicate elements removed. -date: 2017-02-01 -publishdate: 2017-02-01 -lastmod: 2017-02-01 +description: Takes in a slice or array and returns a slice with duplicate elements removed. categories: [functions] menu: docs: - parent: "functions" + parent: functions keywords: [multilingual,i18n,urls] -signature: ["uniq SET"] -workson: [] -hugoversion: -relatedfuncs: [] -deprecated: false +signature: [uniq SET] aliases: [] --- + ``` -{{ uniq (slice 1 2 3 2) }} -{{ slice 1 2 3 2 | uniq }} -<!-- both return [1 2 3] --> +{{ slice 1 3 2 1 | uniq }} --> [1 3 2] + ``` diff --git a/docs/content/en/functions/urls.Parse.md b/docs/content/en/functions/urls.Parse.md index 676734210..988ecb3ac 100644 --- a/docs/content/en/functions/urls.Parse.md +++ b/docs/content/en/functions/urls.Parse.md @@ -1,6 +1,6 @@ --- title: urls.Parse -description: Parse parses a given url, which may be relative or absolute, into a URL structure. +description: Parse parses a given URL, which may be relative or absolute, into a URL structure. date: 2017-09-25 publishdate: 2017-09-25 lastmod: 2017-09-25 |