42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# hugo-notice
|
|
|
|
<!--
|
|
[](https://github.com/budparr/awesome-hugo)
|
|
-->
|
|
|
|
## About
|
|
|
|
This is not a standalone theme. It is a [Hugo](https://gohugo.io) theme component providing a shortcode: `notice` to display nice notices. Four notice types are provided: `warning`, `info`, `note` and `tip`.
|
|
|
|
This components comes with english, french and german localizations for the notice heading. Other languages welcome! Send your pull request.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
1. Add the `hugo-notice` as a submodule to be able to get upstream changes later `git submodule add https://github.com/martignoni/hugo-notice.git themes/hugo-notice`
|
|
2. Add `hugo-notice` as the left-most element of the `theme` list variable in your site's or theme's configuration file `config.yaml` or `config.toml`. Example, with `config.yaml`:
|
|
```yaml
|
|
theme: ["hugo-notice", "my-theme"]
|
|
```
|
|
or, with `config.toml`,
|
|
```toml
|
|
theme = ["hugo-notice", "my-theme"]
|
|
```
|
|
3. In your site, use the shortcode, this way:
|
|
```go
|
|
{{% notice warning %}}
|
|
This is a warning notice. Be warned!
|
|
{{% /notice %}}
|
|
```
|
|
or
|
|
```go
|
|
{{% notice tip %}}
|
|
This is a very good tip.
|
|
{{% /notice %}}
|
|
```
|
|
|
|
### Credits
|
|
|
|
Copyright © 2019 onwards, Nicolas Martignoni nicolas@martignoni.net.
|