Shortcode Params

Describe the parameter definitions of the Hugo shortcode, which is useful for writing shortcode's documentation.

Syntax

1{{% hugo/shortcode-params [data] %}}

Parameters

data

PositionNameTypeRequiredDefaultSince
#0datastring--

The data filename.

heading

PositionNameTypeRequiredDefaultSince
-headingstring-Parameters-

The heading.

headingStartLevel

PositionNameTypeRequiredDefaultSince
-headingStartLevelnumber-2-

The heading start level.

Data Item Properties

name

NameTypeRequiredDefaultSince
namestring--

The parameter name.

position

NameTypeRequiredDefaultSince
positionnumber---

The index of positional parameter.

type

NameTypeRequiredDefaultSince
typestring-string-

The type of parameter.

required

NameTypeRequiredDefaultSince
requiredboolean-false-

Indicates whether if the parameter is required.

default

NameTypeRequiredDefaultSince
defaultstring---

The default value of parameter.

since

NameTypeRequiredDefaultSince
sincestring---

Indicates the version in which the parameter is added.

description

NameTypeRequiredDefaultSince
descriptionstring/object--

The description, support Markdown.

description.default

NameTypeRequiredDefaultSince
description.defaultstring---

The default description.

description.[lang]

NameTypeRequiredDefaultSince
description.[lang]string---

Language-specific description.

options

NameTypeRequiredDefaultSince
optionsarray---

Available options.

deprecated

NameTypeRequiredDefaultSince
deprecatedstring-false-

Indicates whether if the parameter is deprecated.

Example

data/example-params.yaml
 1- name: foo
 2  position: 0
 3  required: true
 4  description:
 5    default: Foo description.
 6    zh-hans: Foo 描述。
 7    zh-hant: Foo 描述。
 8
 9- name: bar
10  type: number
11  since: v0.2.0
12  deprecated: true
13  description:
14    default: Bar description.
15    zh-hans: Bar 描述。
16    zh-hant: Bar 描述。
17
18- name: fizz
19  description: Single description without translations.
20  options:
21    - one
22    - two

Result as follows.

1{{% hugo/shortcode-params data="data/example-params.yaml" heading="Example Parameters" headingStartLevel=3 %}}

Example Parameters

foo

PositionNameTypeRequiredDefaultSince
#0foostring--

Foo description.

bar

PositionNameTypeRequiredDefaultSince
-barnumber--v0.2.0

Bar description.

fizz

PositionNameTypeRequiredDefaultSince
-fizzstring---

Single description without translations.

Available options: one, two.