mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-11-30 11:13:06 +00:00
213 lines
4.2 KiB
Markdown
213 lines
4.2 KiB
Markdown
+++
|
|
description = "Disclaimers to help you structure your page"
|
|
title = "Notice"
|
|
+++
|
|
|
|
The notice shortcode shows four types of disclaimers to help you structure your page.
|
|
|
|
## Usage
|
|
|
|
````go
|
|
{{%/* notice ( note | info | tip | warning ) [ <string> [ <string> ] ] */%}}
|
|
Some markup
|
|
{{%/* /notice */%}}
|
|
````
|
|
|
|
The first parameter is required and indicates the type of notice.
|
|
|
|
The second parameter is optional. If provided, it will be used as the title of the notice. If not provided, then the type of notice will be used as the title. For example, the title of a warning notice will be "Warning".
|
|
|
|
The third parameter is optional. If provided, it will set the icon of near the title. For the standard types of notices, this is automatically determined but can be overridden with this parameter. If you want no icon at all, you have to set this parameter to `" "` (a non empty string filled with spaces).
|
|
## Examples
|
|
|
|
### Note
|
|
|
|
{{% notice note %}}
|
|
A **notice** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{% /notice %}}
|
|
|
|
{{% expand "Show markup" %}}
|
|
````go
|
|
{{%/* notice note */%}}
|
|
A **notice** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{%/* /notice */%}}
|
|
````
|
|
{{% /expand %}}
|
|
|
|
### Info
|
|
|
|
{{% notice info %}}
|
|
An **information** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{% /notice %}}
|
|
|
|
{{% expand "Show markup" %}}
|
|
````go
|
|
{{%/* notice info */%}}
|
|
An **information** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{%/* /notice */%}}
|
|
````
|
|
{{% /expand %}}
|
|
|
|
### Tip
|
|
|
|
{{% notice tip %}}
|
|
A **tip** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{% /notice %}}
|
|
|
|
{{% expand "Show markup" %}}
|
|
````go
|
|
{{%/* notice tip */%}}
|
|
A **tip** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{%/* /notice */%}}
|
|
````
|
|
{{% /expand %}}
|
|
|
|
### Warning
|
|
|
|
{{% notice warning %}}
|
|
A **warning** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{% /notice %}}
|
|
|
|
{{% expand "Show markup" %}}
|
|
````go
|
|
{{%/* notice warning */%}}
|
|
A **warning** disclaimer
|
|
|
|
You can add:
|
|
|
|
- multiple paragraphs
|
|
- bullet point lists
|
|
- _emphasized_, **bold** and even ***bold emphasized*** text
|
|
- [links](https://example.com)
|
|
- other shortcodes besides `notice`
|
|
- etc.
|
|
|
|
```plaintext
|
|
...and even source code
|
|
```
|
|
|
|
> the possiblities are endless
|
|
{{%/* /notice */%}}
|
|
````
|
|
{{% /expand %}}
|
|
|
|
### Notice with default color, custom title and icon
|
|
|
|
You can customize the title of the notice by passing it as a second parameter.
|
|
|
|
{{% notice default "Pay Attention to this Note!" "skull-crossbones" %}}
|
|
The title is now the parameter that was provided.
|
|
{{% /notice %}}
|
|
|
|
{{% expand "Show markup" %}}
|
|
````go
|
|
{{%/* notice default "Pay Attention to this Note!" "skull-crossbones" */%}}
|
|
The title is now the parameter that was provided.
|
|
{{%/* /notice */%}}
|
|
````
|
|
{{% /expand %}}
|