Andrew Woodlee
4b382bddd9
* Getting environment variables and passwords from Vault (not tested yet) * Vault configuration to config (not tested yet) * Ability to run scripts from file on local machine on the remote host * Ability to get ouput in the notification of a list for individual commands or all commands * Make SSH connections close after all commands have been run; reuse previous connections if needed
2.8 KiB
+++ aliases = "/cont/icons" description = "Nice icons for your page" title = "Icon" +++
The icon shortcode displays icons using the Font Awesome library.
{{% icon exclamation-triangle %}} {{% icon angle-double-up %}} {{% icon skull-crossbones %}}
Usage
While the examples are using shortcodes with positional parameter you are free to also call this shortcode from your own partials.
{{< tabs groupId="shortcode-parameter">}} {{% tab title="shortcode" %}}
{{%/* icon icon="exclamation-triangle" */%}}
{{%/* icon icon="angle-double-up" */%}}
{{%/* icon icon="skull-crossbones" */%}}
{{% /tab %}} {{% tab title="shortcode (positional)" %}}
{{%/* icon exclamation-triangle */%}}
{{%/* icon angle-double-up */%}}
{{%/* icon skull-crossbones */%}}
{{% /tab %}} {{% tab title="partial" %}}
{{ partial "shortcodes/icon.html" (dict
"context" .
"icon" "exclamation-triangle"
)}}
{{ partial "shortcodes/icon.html" (dict
"context" .
"icon" "angle-double-up"
)}}
{{ partial "shortcodes/icon.html" (dict
"context" .
"icon" "skull-crossbones"
)}}
{{% /tab %}} {{< /tabs >}}
Parameter
| Name | Position | Default | Notes |
|---|---|---|---|
| icon | 1 | <empty> | [Font Awesome icon name]({{%relref "#finding-an-icon" %}}) to be displayed. It will be displayed in the text color of its according context. |
Finding an icon
Browse through the available icons in the Font Awesome Gallery. Notice that the free filter is enabled, as only the free icons are available by default.
Once on the Font Awesome page for a specific icon, for example the page for the heart, copy the icon name and paste into the Markdown content.
Customising Icons
Font Awesome provides many ways to modify the icon
- Change color (by default the icon will inherit the parent color)
- Increase or decrease size
- Rotate
- Combine with other icons
Check the full documentation on web fonts with CSS for more.
Examples
Standard Usage
Built with {{%/* icon heart */%}} by Relearn and Hugo
Built with {{% icon heart %}} by Relearn and Hugo
Advanced HTML Usage
While the shortcode simplyfies using standard icons, the icon customisation and other advanced features of the Font Awesome library requires you to use HTML directly. Just paste the <i> HTML into markup and Font Awesome will load the relevant icon.
Built with <i class="fas fa-heart"></i> by Relearn and Hugo
Built with by Relearn and Hugo