mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-11-30 11:13:06 +00:00
76 lines
1.5 KiB
Markdown
76 lines
1.5 KiB
Markdown
+++
|
|
description = "Get value of site params"
|
|
title = "SiteParam"
|
|
+++
|
|
|
|
The `siteparam` shortcode prints values of site params.
|
|
|
|
## Usage
|
|
|
|
While the examples are using shortcodes with named parameter you are free to use positional aswell or call this shortcode from your own partials.
|
|
|
|
{{< tabs groupid="shortcode-parameter">}}
|
|
{{% tab title="shortcode" %}}
|
|
|
|
````go
|
|
{{%/* siteparam name="editURL" */%}}
|
|
````
|
|
|
|
{{% /tab %}}
|
|
{{% tab title="shortcode (positional)" %}}
|
|
|
|
````go
|
|
{{%/* siteparam "editURL" */%}}
|
|
````
|
|
|
|
{{% /tab %}}
|
|
{{% tab title="partial" %}}
|
|
|
|
````go
|
|
{{ partial "shortcodes/siteparam.html" (dict
|
|
"page" .
|
|
"name" "editURL"
|
|
)}}
|
|
````
|
|
|
|
{{% /tab %}}
|
|
{{< /tabs >}}
|
|
|
|
### Parameter
|
|
|
|
| Name | Position | Default | Notes |
|
|
|----------------------|----------|------------------|-------------|
|
|
| **name** | 1 | _<empty>_ | The name of the site param to be displayed. |
|
|
|
|
## Examples
|
|
|
|
### `editURL` from `config.toml`
|
|
|
|
```go
|
|
`editURL` value: {{%/* siteparam name="editURL" */%}}
|
|
```
|
|
|
|
`editURL` value: {{% siteparam name="editURL" %}}
|
|
|
|
### Nested parameter with Markdown and HTML formatting
|
|
|
|
To use formatted parameter, add this in your `config.toml`:
|
|
|
|
````toml
|
|
[markup.goldmark.renderer]
|
|
unsafe = true
|
|
````
|
|
|
|
{{% tab title="config.toml" %}}
|
|
````toml
|
|
[params]
|
|
[params.siteparam.test]
|
|
text = "A **nested** parameter <b>with</b> formatting"
|
|
````
|
|
{{% /tab %}}
|
|
|
|
```go
|
|
Formatted parameter: {{%/* siteparam name="siteparam.test.text" */%}}
|
|
```
|
|
|
|
Formatted parameter: {{% siteparam name="siteparam.test.text" %}}
|