Tree
The tree
shortcode displays a list as a tree with configurable icons and colors.
- home
- .config
- My Documents
- home.php
Usage
```tree
- home::folder
- .config::folder
- My Documents::folder::magic
- home.php::fa-fw fab fa-php::#888cc4
```
{{% tree %}}
- home::folder
- .config::folder
- My Documents::folder::magic
- home.php::fa-fw fab fa-php::#888cc4
{{% /tree %}}
{{ partial "shortcodes/tree.html" (dict
"page" .
"content" `- home::folder
- .config::folder
- My Documents::folder::magic
- home.php::fa-fw fab fa-php::#888cc4`
)}}
Codefence syntax is widely available in other Markdown parsers like GitHub and therefore is the recommend syntax for generating portable Markdown.
Parameter
Name | Default | Notes |
---|---|---|
<content> | <empty> | Your list as Markdown. |
Item Syntax
<TEXT> [ :: <ICON> [ :: <COLOR> ] ]
Text can be followed by optional double colons (::
) to define an icon and another optional double colons to define the icon’s color.
-
ICON: Font Awesome icon name set to the left of the text. If you give a single string, it is selected from Font Awesome’s solid icons. If you want to use a different set, you have to give the complete styles after the double colons. See above example for the
home.php
. -
COLOR: The CSS color value to be used. If not set, the primary color will be used.
You can also set a style value known from other shortcodes.
- by severity:
caution
,important
,info
,note
,tip
,warning
- by brand color:
primary
,secondary
,accent
- by color:
blue
,cyan
,green
,grey
,magenta
,orange
,red
- by special color:
default
,transparent
,code
- you can also define your own styles.
If a style and a named HTML color have the same name, the HTML color will be used.
- by severity: