Merge commit 'e509cac533600cf4fa8382c9cdab78ddd82db688'

This commit is contained in:
Bjørn Erik Pedersen
2023-10-20 09:43:56 +02:00
298 changed files with 4568 additions and 1991 deletions

View File

@@ -0,0 +1,45 @@
---
title: encoding.Base64Decode
linkTitle: base64Decode
description: Returns the base64 decoding of the given content.
categories: [functions]
keywords: []
menu:
docs:
parent: functions
function:
aliases: [base64Decode]
returnType: string
signatures: [encoding.Base64Decode INPUT]
signatures:
-
- base64Decode INPUT
aliases: [/functions/base64Decode]
---
```go-html-template
{{ "SHVnbw==" | base64Decode }} → "Hugo"
```
Use the `base64Decode` function to decode responses from APIs. For example, the result of this call to GitHub's API contains the base64-encoded representation of the repository's README file:
```text
https://api.github.com/repos/gohugoio/hugo/readme
```
To retrieve and render the content:
```go-html-template
{{ $u := "https://api.github.com/repos/gohugoio/hugo/readme" }}
{{ with resources.GetRemote $u }}
{{ with .Err }}
{{ errorf "%s" . }}
{{ else }}
{{ with . | transform.Unmarshal }}
{{ .content | base64Decode | markdownify }}
{{ end }}
{{ end }}
{{ else }}
{{ errorf "Unable to get remote resource %q" $u }}
{{ end }}
```

View File

@@ -0,0 +1,22 @@
---
title: encoding.Base64Encode
linkTitle: base64Encode
description: Returns the base64 decoding of the given content.
categories: [functions]
keywords: []
menu:
docs:
parent: functions
function:
aliases: [base64Encode]
returnType: string
signatures: [encoding.Base64Encode INPUT]
relatedFunctions:
- encoding.Base64Decode
- encoding.Base64Encode
aliases: [/functions/base64, /functions/base64Encode]
---
```go-html-template
{{ "Hugo" | base64Encode }} → "SHVnbw=="
```

View File

@@ -0,0 +1,48 @@
---
title: encoding.Jsonify
linkTitle: jsonify
description: Encodes a given object to JSON.
categories: [functions]
keywords: []
menu:
docs:
parent: functions
function:
aliases: [jsonify]
returnType: template.HTML
signatures:
- encoding.Jsonify INPUT
- encoding.Jsonify OPTIONS INPUT
relatedFunctions:
- encoding.Jsonify
- transform.Remarshal
- transform.Unmarshal
aliases: [/functions/jsonify]
---
To customize the printing of the JSON, pass a map of options as the first
argument. Supported options are "prefix" and "indent". Each JSON element in
the output will begin on a new line beginning with *prefix* followed by one or
more copies of *indent* according to the indentation nesting.
```go-html-template
{{ dict "title" .Title "content" .Plain | jsonify }}
{{ dict "title" .Title "content" .Plain | jsonify (dict "indent" " ") }}
{{ dict "title" .Title "content" .Plain | jsonify (dict "prefix" " " "indent" " ") }}
```
## Options
indent ("")
: Indentation to use.
prefix ("")
: Indentation prefix.
noHTMLEscape (false)
: Disable escaping of problematic HTML characters inside JSON quoted strings. The default behavior is to escape &, <, and > to \u0026, \u003c, and \u003e to avoid certain safety problems that can arise when embedding JSON in HTML.
See also the `.PlainWords`, `.Plain`, and `.RawContent` [page variables][pagevars].
[pagevars]: /variables/page/